README.md

• Online manga catalogues (with 1200+ manga sources)
• Support for Tachiyomi keiyoushi extensions
• Search manga by name, genres and more filters
• Favorites organized by user-defined categories
• Reading history, bookmarks and incognito mode support
• Download manga and read it offline. Third-party CBZ archives are also supported
• Clean and convenient Material You UI, optimized for phones, tablets and desktop
• Standard and Webtoon-optimized customizable reader, gesture support on reading interface
• Notifications about new chapters with updates feed, manga recommendations (with filters)
• Integration with manga tracking services: Shikimori, AniList, MyAnimeList, Kitsu
• Password / fingerprint-protected access to the app
• Automatically sync app data with other devices on the same account
• Support for older devices running Android 6.0+

Development Setup

Prerequisites

• JDK 17 (recommended: Temurin distribution)
• Android SDK (compile SDK 36, build tools 35.0.0, minimum SDK 23)
• Android Studio (recommended) or Android SDK command-line tools

Building the Project

1. Clone the repository:

   git clone https://github.com/AppFuton/Futon.git
   cd Futon
   

2. Build debug APK:

   ./gradlew assembleDebug
   

   Output: app/build/outputs/apk/debug/app-debug.apk

3. Build release APK:

   ./gradlew assembleRelease
   

   Output: app/build/outputs/apk/release/app-release.apk

   Note: Requires keystore setup via environment variables or local.properties

4. Build nightly APK:

   ./gradlew assembleNightly
   

   Output: app/build/outputs/apk/nightly/app-nightly.apk

Running Tests

• Unit tests:

  ./gradlew test
  

• Instrumented tests:

  ./gradlew connectedDebugAndroidTest
  

Code Quality

• Lint check:

  ./gradlew lint
  

• Full check (lint + tests):

  ./gradlew check
  

For detailed contribution guidelines, see CONTRIBUTING.md.

You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.

The developers of this application do not have any affiliation with the content available in the app and does not store or distribute any content. This application should be considered a web browser, all content that can be found using this application is freely available on the Internet. All DMCA takedown requests should be sent to the owners of the website where the content is hosted.

Futon is built upon the exceptional work of the Kotatsu project.

We are deeply grateful to:

• The original Kotatsu developers for creating such an outstanding manga reader and making it open source
• The Kotatsu community for their contributions, testing, and support
• All translators who helped localize Kotatsu through Weblate
• Kotatsu-Redo for continuing parser development and maintenance
• Kototoro for the Tachiyomi extension integration guide

This project stands on the shoulders of giants. The Kotatsu team's dedication to creating a feature-rich, user-friendly manga reader has provided an incredible foundation for Futon to build upon.

Thank you to everyone who contributed to Kotatsu — your work continues to benefit the manga reading community!

For the original Kotatsu project, please visit: github.com/KotatsuApp/Kotatsu