license Crowdin Ask DeepWiki Telegram Discord

badge-Android badge-iOS badge-Windows badge-macOS

Flare is an open-source social client that merges your feeds from Mastodon, Misskey, Bluesky, X, and RSS into a single timeline, turning it into your personal information hub, with Android/iOS and macOS/Windows Support.

• Consolidate all your social networks into one client, featuring Mastodon, Misskey, Bluesky and more to come.
• Crosspost your content simultaneously across all your platforms.
• It is FOSS and privacy-centric.

Here're some features we're planning to implement in the future.

• Grouped Mixed timeline
• Showing instance's announcement
• Crossposting for repost
• Auto thread
• AI powered features
  • Personal trends of the day
  • Quick reply
• Support for Meta Threads
• Support for Discourse forum
• Desktop Client
• Web Client(?)

Here're some features we've done before.

• Mixed timeline
• AI powered features
  • Translation
  • Summary
• Anonymous mode enhancement, option to change data source
• Local history
• RSS feed support
• Support for vvo platform
• Anonymous mode, no need to login
• Customizable tabs
• Local filtering
• Crossposting
• Translation

• Support for polls
• Support global/local timelines
• Support for lists
• Support for bookmarks/faovrites timelines

• Support for polls
• Support for lists
• Support for antennas
• Support for faovrites timeline

• Support for lists
• Support for feeds
• Support DM

• Make sure you have JDK 21 installed
• Run ./gradlew installDebug to build and install the debug version of the app
• You can open the project in Android Studio or IntelliJ IDEA if you want

• Make sure you have a Mac with Xcode 26 installed
• open iosApp/Flare.xcodeproj in Xcode
• Build and run the app

• Flare Server uses Ktor with Kotlin Native, which only works on Linux X64 and MacOS X64/ARM64
• Make sure you have JDK 21 installed
• Run ./gradlew :server:runDebugExecutableMacosArm64 -PrunArgs="--config-path=path/to/server/src/commonMain/resources/application.yaml" to build and run the server, remember to replace path/to/server/src/commonMain/resources/application.yaml with the path to your config file
• The server will run on http://localhost:8080 by default

If you prefer using Docker, you can use Docker Compose to run prebuild Server Image.

• Rename .env.sample to .env, and update the environment variables in the file.
• If you're deploying into a production server, you might need to update the docker-compose.yml file with these lines:

  environment:
  - # STAGE: local
  + STAGE: 'production'
  - DOMAINS: api.flareapp.moe -> http://flare-backend:8080
  + DOMAINS: your_domain_here -> http://flare-backend:8080

• Run docker compose up -d

• Make sure you have JDK 21 installed, JBR-21 is recommended.

• Make sure you have Xcode 26 installed
• Run ./gradlew run to build and run the debug version of the desktop app.

• Make sure you have Visual Studio 2022 installed with Windows App development installed
• Open desktopApp/src/main/csharp/Flare.csproj with Visual Studio
• Click Run and you should able to build and run the app.

See CONTRIBUTING.md for more information.

This project is licensed under the AGPL-3.0 license.