Kiri

Take control of your social media experience with essential privacy controls and media tools for Facebook and Instagram.

Kiri is a lightweight, open-source browser extension that adds missing features and privacy controls to Facebook and Instagram.

✨ Features

• 👻 Ghost Mode: Read messages, hide your typing indicator, and watch stories anonymously. (Supports E2EE chats).
• ⬇️ Native Video Downloads: Save high-quality MP4 videos directly from Facebook and Instagram feeds.
• 🎨 Custom Reactions: React to Facebook Stories with any emoji you want.

🛠️ Tech Stack

• Framework: WXT
• UI: React 19, Tailwind CSS v4, Framer Motion, Radix UI
• Tooling: Bun, Vite

🚀 Getting Started

Prerequisites

• Bun (v1.0+)

Installation

1. Clone the repository:

git clone https://github.com/rumi-chan/kiri.git
cd kiri

2. Install dependencies:

bun install

Development

Chrome / Edge

1. Run the development server for Chrome:

bun dev:chrome

(Use bun dev:edge for Microsoft Edge)

2. Open your browser and navigate to the Extensions page (chrome://extensions or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the build/chrome-mv3 (or build/edge-mv3) directory located in the project root.

Firefox

1. Run the development server:

bun dev:firefox

2. Open Firefox and go to about:debugging#/runtime/this-firefox.
3. Click Load Temporary Add-on...
4. Select the build/firefox-mv2/manifest.json file.

Note

In Firefox, you are adding the extension in temporary mode. It will be removed when you close the browser.

📦 Publishing

Manual Build

To build the extension for production:

bun run build          # Builds for all target browsers
bun run build:chrome   # Builds only for Chrome
bun run build:firefox  # Builds only for Firefox

The output .zip files will be generated in the .wxt or build directory, ready for upload to the Chrome Web Store and Firefox Add-ons.

CI/CD

Publishing is automated via GitHub Actions:

1. Obtain all the required API keys.
2. Set your API keys as GitHub Secrets.
3. Run the CI / Publish workflow from the Actions tab.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes using conventional commits (git commit -m 'feat: Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Star History