/Boorusama

A mobile client for booru sites built with Flutter

Primary LanguageDartGNU General Public License v3.0GPL-3.0

Boorusama Logo

License Discord codecov test

Boorusama Logo

📚 Overview

Boorusama is an unofficial, feature-rich client for Danbooru and other booru based site, built with Flutter.

Banner_1 Banner_2

🚀 Features

Boorusama offers a wide range of functionalities including:

  • Support for Danbooru-based sites, and some sites based on Gelbooru and Moebooru
  • Full tag search capabilities with autocomplete and metatags highlighting
  • Ability to save searches
  • Options to save, import, export your favorite tags
  • Quick and easy image saving
  • Bulk download of multiple images
  • Exploration of newest, curated, and popular posts
  • Voting and commenting functionalities
  • Viewing translation notes
  • Image pool search, filter, and view
  • Tag blacklisting
  • Creation and management of multiple favorite groups based on different interests or projects.

📥 Installation

Prerequisites:

Steps:

  1. Clone the repository:
git clone https://github.com/khoadng/Boorusama.git
cd Boorusama
  1. Install dependencies and generate boilerplate code:
flutter pub get
flutter pub run build_runner build --delete-conflicting-outputs
  1. Configure Firebase (Skip if you use the boorusama-foss branch):
dart pub global activate flutterfire_cli
flutterfire configure
  1. Connect to an Android device/emulator and run the app:
flutter run --release

Or build an APK and install it manually:

flutter build apk --release

🌐 Translation

Help us translate Boorusama to make it more accessible. Here are the steps:

  1. Fork this repository
  2. Use the English translations as a reference
  3. Create a new JSON file in translation folder using your two-letter language code
  4. Submit a PR
Language Contributors Source
English @khoadng en-US.json
Vietnamese @khoadng vi-VN.json
Japanese @khoadng ja-JP.json
Russian @lesh6295-png ru-RU.json
Belarusian @lesh6295-png be-BY.json
German @Forsaken5687 de-DE.json
Chinese (Traditional) @xperiazu21 zh-TW.json

Alternatively, you can assist with translations on POEditor.

📝 Feedback & Issues

Feel free to send me feedback on Discord or file an issue. Feature requests are always welcome.

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.