Welcome to Philomena Multi-Booru! This is an advanced and highly customizable gallery viewer built specifically to run multiple instances of Derpibooru (and other Philomena-based boorus) in a single, unified interface.
If you regularly browse different boorus and want a seamless way to aggregate your searches, manage your favorite artists, and view high-quality artwork without juggling multiple browser tabs, this project is for you!
- Multi-Instance Support: Connect and seamlessly switch between multiple Derpibooru-style instances.
- Unified Searching & Pagination: Browse through images from different boorus with a smart local cache system that keeps your pagination intact.
- Rich Media Player: Integrated with Vidstack for a smooth, customizable video playback experience (supports autoplay, loop, and mute settings).
- Deep Customization: A built-in theme editor allows you to change global colors, text styles, and interaction symbols to match your aesthetic perfectly.
- Optional In-App Viewing: Check out images, read comments, and explore user profiles without ever leaving the app.
This entire application is built around and strictly limited by the capabilities of the official Philomena API.
Because we rely entirely on the endpoints provided by the platform, not every native website feature can be brought into this app right now. However, the project is actively maintained! Whenever the Philomena API receives updates that open the door for new functionalities, they will be implemented here as soon as possible.
Your data is yours. Philomena Multi-Booru does not collect, track, or send any of your personal information to external servers.
- Local Storage Only: Everything—from your cached images and search history to your custom themes—is stored locally in your browser using IndexedDB (JsStore) and LocalStorage.
- API Key Responsibility: Because your API keys are saved directly within your browser's local environment, keeping them secure is entirely your responsibility. Treat your browser and device security with care, and never share your exported app data if it contains your keys.
- Clone this repository:
git clone https://github.com/Pony-House/Philomena-Multibooru.git- Install the dependencies:
yarn- Development mode: To run the app with hot-reload for development:
yarn dev- Building for production: To generate a production-ready version of the app:
yarn buildThis command will create a /dist folder containing all the optimized website files.
The project includes a pre-configured Service Worker at dist/sw.js. This script is essential for the application's routing, as it ensures that all URL paths are correctly redirected to index.html. This allows the Single Page Application (SPA) to handle deep linking and navigation seamlessly without needing complex server-side rewrites.
- Final Setup: Open the app in your browser, head to the Settings panel, and add your favorite Booru URLs along with your API keys to start syncing!
- Arts to replace AI Images in the project.
You are completely free to copy, adapt, or implement any part of this project into the official Philomena version. Credits aren't required, but receiving them would honestly make me feel so grateful and happy.
Enjoy your unified browsing experience! If you run into any issues or have feature requests (that the API allows!), feel free to open an issue.
🧠 Note: This documentation was written by Gemini, an AI assistant developed by Google, based on the project structure and descriptions provided by the repository author.
If you find any inaccuracies or need improvements, feel free to contribute or open an issue!
Made with tiny love! 🍮
