Skip to content

Latest commit

Β 

History

230 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Sozo

Films, series, anime, manga and novels β€” in one app. Android, TV, iOS and desktop.

Release Downloads Stars License Issues

Android Android TV Windows Linux macOS iOS Flutter


Download Β  Telegram Β  Discord



What it is Β· Features Β· Download Β· Screenshots Β· How sources work Β· Built with Β· FAQ Β· Disclaimer Β· License


🎬 What Sozo is

Sozo is an open-source Flutter app for finding, watching, reading and keeping track of films, series, anime, manga and light novels. The name is Japanese for creation, imagination.

It runs in three modes β€” Video, Manga and Novel β€” each with its own sources and its own player or reader. On top of that: an Android TV interface, Chromecast, torrents, watching together, and real desktop builds.

Sozo hosts nothing. It is a client: you choose which sources to install, and it plays what they return. See How sources work and the Disclaimer.

Note

Your lists, progress and history sync across devices.

🎬 Watch πŸ“š Read πŸ“ˆ Track πŸ”„ Sync
Films, series, anime Manga and novels AniList & MAL Every device

✨ Features

🍿 Watching

  • Two player engines: libmpv (media_kit) and the platform player
  • Anime4K and other shader presets
  • Quality, audio track, speed, picture-in-picture
  • Subtitles: online search + automatic translation
  • Opening/ending skip, hand off to an external player
  • Chromecast and Android TV
  • DRM playback

πŸ“š Reading

  • Manga, manhwa and webtoon reader
  • Light novel mode
  • Mangayomi and Aniyomi sources

πŸ”Ž Finding

  • Cross-provider search β€” every source at once
  • Voice search
  • Live TV channels
  • Shorts β€” a stream of short trailers

🧩 Extensions

  • Aniyomi extensions
  • CloudStream plugins
  • Mangayomi repositories
  • Your own JavaScript providers
  • Torrents β€” Nyaa, Sukebei, Tokyo Toshokan

πŸ‘₯ Social

  • Watch Party β€” watch together in real time
  • Comments and ratings
  • Streaks and statistics
  • Trivia game with a leaderboard
  • AniList and MyAnimeList trackers

Also: offline downloads Β· private lists Β· PIN and biometric lock Β· 11 languages Β· TV remote support Β· in-app updates Β· DNS over HTTPS for source traffic


⬇️ Download

The latest build is on the Releases page.

πŸ“± Android

File Who it is for
🟒 Sozo-vX.Y.Z-arm64-v8a.apk Modern 64-bit phones β€” recommended
🟑 Sozo-vX.Y.Z-armeabi-v7a.apk Older 32-bit devices
πŸ”΅ Sozo-vX.Y.Z-universal.apk If you are not sure β€” works everywhere, just larger
πŸ“Ί Sozo-vX.Y.Z-tv.apk Android TV, Google TV, Shield, TV boxes

πŸ’» Desktop

File Platform
πŸͺŸ Sozo-vX.Y.Z-Windows-portable.zip Windows 10/11 β€” unzip and run
🐧 Sozo-vX.Y.Z-Linux-x64.tar.gz Linux x64
🍎 Sozo-vX.Y.Z-macOS.dmg macOS (unsigned β€” see the FAQ below)

Tip

Sozo checks for new versions itself and updates in place from Profile β†’ Check for updates.


πŸ“Έ Screenshots


🏠 Home

πŸ“„ Details

⚑ Shorts

πŸ” Search

▢️ Player

πŸ‘€ Profile

🧩 Platforms

Platform Status
πŸ€– Android βœ… Released
πŸ“Ί Android TV βœ… Released
πŸͺŸ Windows βœ… Released
🐧 Linux βœ… Released
🍎 macOS βœ… Released (unsigned)
πŸ“± iOS πŸ§ͺ Beta (sideload)
πŸ“Ί Apple TV 🚧 Planned
  • Android
  • Android TV
  • Windows / Linux / macOS
  • iOS beta
  • Apple TV (tvOS)
  • F-Droid

πŸ”Œ How sources work

This is the part that decides whether anything plays, so it is worth stating plainly.

Sozo ships with no content of its own. What it ships is the runtimes; you install sources into them.

Ecosystem What it is Where it runs
Sozo Our own cloud sources, served by the backend Server
CloudStream .cs3 plugins from CloudStream repositories On the device, in a class loader
Aniyomi Anime extension APKs On the device, in a class loader
Manga Mihon/Tachiyomi extension APKs On the device, in a class loader
Mangayomi JavaScript sources, including every novel source On the device, in a JS runtime

Add a repository from Profile β†’ Sources β†’ Add source, install what you want, and pick it from the source switcher on the home screen. Novels come from Mangayomi repositories specifically β€” that is the only ecosystem that publishes them.

A source that stops working almost always stopped working on its own: sites move, shut down, or start blocking. Sozo now says which of those happened rather than printing the exception, and Profile β†’ Sources β†’ DNS can route name lookups through Cloudflare, Google, Quad9, AdGuard or Mullvad for the case where a provider blocks a site by refusing to resolve it. That is not a VPN: it does not hide your traffic and does not change your IP.


πŸ›  Built with

Stack
Layer What it uses
Framework Flutter + Dart
State flutter_bloc Β· get_it (DI) Β· go_router
Player media_kit (libmpv) + the platform video_player
Storage Hive + flutter_secure_storage
Networking Dio + a cookie jar
Extension runtimes DexClassLoader (Aniyomi, Manga, CloudStream) + a headless WebView for JavaScript sources
Backend Node.js (sozo-backend)

The architecture is feature-first clean architecture: lib/core/ for what everything shares, and lib/features/<feature>/{data,domain,presentation} for the rest.


πŸ— Building it

git clone https://github.com/professorDeveloper/sozo.git
cd sozo
flutter pub get

# .env is declared as a pubspec asset, so the build fails without it
cp .env.example .env

flutter run

Requires the Flutter SDK (Dart ^3.11.1), Android SDK 34+ and JDK 17.

More in CONTRIBUTING.md.


❓ FAQ

Does Sozo host any content?
No. Sozo is a client and a tracker. It stores nothing, distributes nothing, and does not run the extensions it loads. See the Disclaimer.
There are no sources after I install it. Is it broken?
No β€” that is the starting state. Extension sources are installed, not built in. Open Profile β†’ Sources β†’ Add source, add a repository, and install the ones you want. See How sources work.
Which APK should I download?
arm64-v8a on any modern phone. If you are not sure, or Android says "package not compatible", take universal.
macOS says the app is damaged and will not open
The DMG is not signed with an Apple certificate (that costs $99 a year). Run this once:
xattr -dr com.apple.quarantine /Applications/Sozo.app
Or right-click Sozo.app in Applications β†’ Open β†’ Open.
A source stopped working, or a video will not play
Almost always the source itself rather than the app: sites move, shut down, or start blocking. The error on screen now says which. Two things worth trying first β€” pick another source for the same title with Try another source, and set Profile β†’ Sources β†’ DNS to Cloudflare if your provider blocks by DNS.

If it still fails, report it with the source not working template and include the exact message.
Is the DNS setting a VPN?
No. It only changes who answers "what is the address of this host". Your traffic takes the same route to the same servers from the same address. It helps when a site is blocked by DNS and does nothing when it is blocked by address.
Is Sozo free?
Yes β€” free and open source under GPL-3.0. No ads, no subscription.
How can I help?
⭐ Star the repo, tell a friend, report a bug, or open a PR β€” see CONTRIBUTING.md.

🀝 Contributing

Every kind of contribution counts β€” code, translations, design, bug reports.


⚠️ Disclaimer

Important

Sozo is a client and a tracker. It does not host, provide, distribute or operate any media content. No content ships inside the app.

  • Sources β€” Sozo works with third-party sources on the open internet and with extensions the user installs themselves. Those sources are not made, controlled or endorsed by Sozo.
  • Responsibility β€” Using the app, and any third-party service reached through it, is entirely the user's responsibility. Users must comply with the laws of their own country and with copyright and intellectual-property requirements.
  • No liability β€” The developer is not liable for misuse of the app, for anything that follows from it, or for breaches involving third-party services.
  • Legal requests β€” Complaints about a particular source or extension belong with the owner of that source, not with Sozo. A takedown request against this repository can only concern the code in this repository.
  • Official APIs β€” Sozo integrates only with the official, public APIs of services such as AniList, MyAnimeList and TMDB.

πŸ“„ License

Sozo β€” Copyright (C) 2026 professorDeveloper

This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License, either version 3 or
(at your option) any later version.

It is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY.

Full text in LICENSE.

What that means: you may fork, modify and redistribute Sozo β€” but a modified version has to stay open source under GPL-3.0 too. You cannot turn Sozo into a closed-source or ad-supported app and sell it on.


If Sozo is useful to you, ⭐ star it. That helps the project more than anything else.

Star Coffee

Made with ❀️ and Flutter · sozo.framer.website

About

Sozo focuses on a cinematic mobile experience: fast browsing, clean visuals, smooth playback, and a layout that feels made for everyday watching. From home discovery to offline downloads, every screen is designed to keep the content first.

Topics

Resources

Contributing

Stars

68 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages