Midori Browser: A lightweight, fast, and secure browser that prioritizes privacy and user choice.
Built on Mozilla Firefox • Open Source • Cross-Platform • Ad Blocker • Workspace Manager

🌐 Official Website ・ 📥 Download ・ 📰 Blog & Release Notes ・ 💬 Support Community ・ 💡 GitHub Discussions

• ✨ Key Features
• 🎬 Screenshots
• ⚡ Get Started
• 📋 System Requirements
• 📥 Installation
• 🏗️ Architecture & Tech Stack
• 🤝 Contributing
• 🐛 Good First Issues for New Contributors
• 📚 Documentation
• 📄 License
• 📧 Contact & Support

📸 Screenshots coming soon! We're updating our gallery to showcase Midori's beautiful interface and powerful features.

In the meantime, visit astian.org/midori-browser for a visual tour.

• OS: Windows 10 or later (Windows 7, 8 not supported)
• Architecture: x86_64 (AArch64 not yet supported)
• Installation: EXE installer or Winget package
• Note: Installer is signed by "Open Source Developer, Astian, Inc". Daylight builds are unsigned.

• OS: macOS 10.12 or later
• Architecture: Universal build (x86_64 + ARM64)
• Installation: DMG with auto-update system
• Note: Apple certification in progress

• Distributions: Debian-based (Ubuntu, Mint) & Arch-based (Manjaro)
• Architecture: x86_64 & AArch64
• Requirements: See Firefox Linux System Requirements
• Installation: APT package via Astian repository

# Add Astian GPG key
sudo wget -O /etc/apt/trusted.gpg.d/midori-archive-keyring.gpg \
  http://repo.astian.org/midori-archive-keyring.gpg

# Add repository
echo "deb http://repo.astian.org midori main" | \
  sudo tee /etc/apt/sources.list.d/midori.list

# Install
sudo apt update
sudo apt install midori

Download from astian.org/midori-browser/download or use:

# Via Homebrew (when available)
brew install midori

Download the EXE installer or use Winget:

winget install midori-browser

Midori Browser is built on Mozilla Firefox's core with custom enhancements:

• Engine: Gecko.
• Frontend: C++, JavaScript, XUL/HTML5
• Extensions: WebExtensions API compatible
• Backend Services: Node.js + TypeScript (Sync, Settings)
• Database: PostgreSQL + SQLite (embedded)
• Build System: Moz.build / Gradle

engine/          # Gecko-based browser engine & UI
src/             # Custom Midori modules & extensions
scripts/         # Build & development scripts
tests/           # E2E tests (Playwright)
locales/         # Multi-language support (60+ languages)
configs/         # Platform-specific configurations

For detailed architecture, see engine/CLAUDE.md and ROADMAP.md.

We ❤️ contributions from the community! Whether you're fixing bugs, adding features, improving docs, or translating Midori, here's how to get started:

1. Fork & Clone

   git clone https://github.com/YOUR-USERNAME/midori-desktop.git
   cd midori-desktop

2. Pick an Issue

   • Start with Good First Issues (labeled good-first-issue)
   • Browse all issues
   • Or start a discussion

3. Set Up Development Environment

   ./mach bootstrap       # One-time setup
   ./mach build          # Build the browser
   ./mach run            # Run Midori locally

4. Make Your Changes

   • Create a feature branch: git checkout -b feature/your-feature
   • Follow code style guidelines
   • Write/update tests as needed

5. Submit a Pull Request

   • Push to your fork
   • Create a PR against main branch
   • Reference related issues: Closes #123
   • Respond to code review feedback

We are committed to providing a welcoming and inclusive environment. Please read our Code of Conduct before contributing.

Looking to make your first contribution? Good First Issues are carefully selected tasks perfect for newcomers while being genuinely useful to the project.

✅ Learn by Contributing — Gain real-world experience with a real-world project
✅ Get Mentorship — Core team reviews and guides your work
✅ Build Your Portfolio — Showcase your work on GitHub
✅ Become a Promoter — Contributors often become our best community ambassadors
✅ Earn Recognition — Featured in monthly contributor spotlights

1. Filter by Label: Issues labeled good-first-issue
2. Filter by Difficulty: Help wanted + documentation
3. Join Discussions: Ask questions in GitHub Discussions

All good-first-issue labeled issues meet these standards:

• ✅ Scoped to 1-2 files maximum
• ✅ Under 200 lines of code change
• ✅ Clear acceptance criteria (what "done" looks like)
• ✅ Step-by-step guide in issue description
• ✅ Mentor assigned (will review your PR)
• ✅ Estimated time: 1-4 hours for someone new to the codebase

💡 Pro Tip: Comment on an issue saying "I'd like to work on this" and a maintainer will assign it to you!

After completing a good first issue, consider:

• 📝 Write a blog post about your experience
• 🐦 Share your PR on social media and tag us
• 🎤 Give feedback on the contribution process
• 🚀 Level up to harder issues and become a core contributor
• 👥 Mentor others in our community

• 📖 Contributing Guide — How to build, test, and submit PRs
• 🏗️ Architecture Documentation — Deep dive into Midori's design
• 🗺️ Roadmap — What's coming next
• 🔒 Security Policy — Responsible disclosure
• 📱 Browser Extension Development — Create Midori extensions
• 🔗 API Documentation — For backend services

# Clone the repository
git clone https://github.com/goastian/midori-desktop.git
cd midori-desktop

# Bootstrap development environment (first time)
./mach bootstrap

# Build Midori
./mach build

# Run development build
./mach run

# Run tests
./mach test

# Run E2E tests
npm run test:e2e

See BUILD.md for platform-specific build instructions and troubleshooting.

Midori Browser is licensed under the Mozilla Public License 2.0 (MPL-2.0).

• ™ Midori Browser name is a registered trademark of Astian, Inc
• © Midori logo is protected by copyright
• 🔗 Midori is based on Mozilla Firefox (Gecko engine)
• ⚠️ Midori is not affiliated with Mozilla or Mozilla Firefox
• 📜 Full license dependencies: FOSSA Report

• 💬 GitHub Discussions — Ask questions & share ideas
• 🌐 Official Support Community — Community forums
• 🐛 Report a Bug — Found an issue?
• 💡 Suggest a Feature — Have an idea?
• 📧 Send Feedback — Direct feedback form

• 🐦 Twitter/X — Latest updates & news
• 💬 Telegram — Chat with the community
• 🎥 Official Website — Learn more

Midori is open-source and maintained by volunteers. Love Midori? Support us:

• ⭐ Star this repository — Shows your support!
• 💝 Donate on Stripe — One-time or recurring
• 🤝 Become a Patron — Monthly support
• 👨‍💻 Contribute Code — Your skills matter most
• 📣 Spread the Word — Tell friends about Midori

Midori Browser is dedicated to providing users with a fast, secure, and private browsing experience that respects their digital rights and gives them control over their data. We believe the web should be free and open for everyone.

Component	Status	Last Updated
CI/CD Pipeline		Daily
Build Status		Weekly
Latest Release		On tag
openSUSE Build		Continuous

• Official Midori Community Telegram

You can contribute through a donation on our website. We recommend that you first read our manifesto and then donate here we leave you the links

• Manifest
• Donate
• Midori on Open collective(https://opencollective.com/midori-browser)

• Astian Privacy Policy

Midori Desktop project is supported by ADS.FUND

See Development

• We want to support as many languages as possible. If you want to translate Midori Browser, please clone the l10n-central repository.

• English is the main language. If you want to translate Midori Browser, please translate from English (en-US)

• Midori's English file is located in the Midori-Strings repository.

• If you find a bug, please report it to the Issues page or using Official Support Site.