Welcome to the official home of the Omu-Sora organization.

Omu is an open-source, multi-platform media client ecosystem engineered around a core architectural principle: complete decoupling. Every client is an independent application layer that interfaces directly with swappable, optimized scraping libraries — with no shared state and no monolithic dependencies.

Rather than hosting media or indexing content, Omu functions as a high-performance native container shell. It translates external web streams, peer-to-peer torrent swarms, and cyberlocker payloads directly into custom native canvas views. This ensures an ad-free, 120Hz playback experience entirely stripped of trackers, cloud cookie injections, and malicious pop-up redirects.

The Omu ecosystem progresses through four distinct, modular stages. Each stage represents a standalone sub-project with dedicated feature specifications and tailored technology stacks:

┌──────────────────────────────────────────────────────────────┐
│                  STAGE 1 — ANIA (ANIME CORE)                 │
│   Media3 ExoPlayer pipeline · Custom control skins           │
│   Active mirror interception · SQLite WAL watch tracking     │
└───────────────────────────────┬──────────────────────────────┘
                                ▼
┌──────────────────────────────────────────────────────────────┐
│                 STAGE 2 — YOMIK (MANGA CORE)                 │
│   Jetpack Compose LazyColumn · Coil bitmap recycling         │
│   AniList GraphQL integration · Native Kotlin parsers        │
└───────────────────────────────┬──────────────────────────────┘
                                ▼
┌──────────────────────────────────────────────────────────────┐
│              STAGE 3 — MOVE-WATT (CINEMA LAYER)              │
│   libtorrent sequential engine · Local loopback proxy        │
│   TMDB metadata bridge · Cyberlocker stream decryptor        │
└───────────────────────────────┬──────────────────────────────┘
                                ▼
┌──────────────────────────────────────────────────────────────┐
│               STAGE 4 — OMU (UNIFIED PLATFORM)               │
│   CI parser validation · Marketplace UI engine               │
│   Trakt.tv sync · Local-first CRDT multi-device merges       │
└──────────────────────────────────────────────────────────────┘

• Active Mirror Interception: Safe, client-side iframe parsing designed to strip tracking scripts and extract clean .m3u8 streams.
• Bespoke Media Controls: Custom-skinned Media3 interface featuring frame-accurate scrubbing, skip-intro macros, and persistent audio toggles (Sub/Dub).
• Asynchronous Bookmark Sync: Multi-threaded bookmarking backed by SQLite Write-Ahead Logging (WAL) to guarantee UI performance.

• LazyColumn Recycler: Memory-safe implementation capping active GPU bitmap allocations at a maximum of three layout sheets.
• Coil-Isolated Bitmaps: Specialized memory recycling preventing out-of-memory (OOM) crashes on large high-resolution manga files.
• Decoupled Parser Backend: Powered by yomik-parsers, a native Kotlin scraping library maintained independently from the visual application.

• Sequential P2P Engine: Custom libtorrent integration designed to fetch chunks in sequence, enabling real-time magnet link streaming.
• Local Loopback Proxy: Converts incoming P2P torrent data feeds into a localized HTTP web cache consumable by standard media renderers.
• QuickJS JavaScript Bridge: An embedded headless Javascript engine (QuickJS) running parser scripts in background pools without WebViews.

• Governance & Marketplace: Hot-swappable settings menu letting users toggle, install, and update scrapers matching manifest.json schemas.
• Ecosystem Sync: Unified sync framework bridging AniList, Trakt.tv, and offline-first CRDT databases for automatic multi-device merges.
• Security Hardening: strict Content Security Policies (CSP) and isolated proxy networks protecting the user's local workspace.

We maintain strict separation of concerns across our repositories to ensure clean compilation steps and isolation from global environment states:

Omu-sora/
├── core-parsers/           # TypeScript web-scraping extension registry (desktop/cinema)
│   ├── contracts/          # Shared type contracts for data schemas
│   └── engines/            # Isolated parser engines (MangaDex, cyberlockers)
│
├── yomik-parsers/          # Native Kotlin manga scraper engine library (compiled as JVM jar)
│   ├── src/main/kotlin/    # Custom Jsoup parsing structures
│   └── build.gradle.kts    # Builds independent jar dependency
│
├── desktop/                # Tauri/Rust desktop dashboard
│   └── src/                # React 18 + TypeScript + Tailwind UI
│
├── mobile-android/         # Native Kotlin Android application
│   ├── java/               # Jetpack Compose UI (Ania, Yomik, Move-Watt)
│   ├── media-pipeline/     # Media3 ExoPlayer config and request wrappers
│   ├── torrent-engine/     # libtorrent sequential fetch buffer
│   └── runtime-bridge/     # QuickJS JNI wrapper execution
│
└── .github/                # Organization profiles & repository configurations

To set up the Omu-Sora environment locally, follow these steps:

# 1. Initialize the Organization Directory
mkdir Omu-sora && cd Omu-sora

# 2. Clone the core parsers repository 
git clone https://github.com/Omu-sora/core-parsers.git

# 3. Synchronize your active node runtimes
nvm install && nvm use && corepack enable

# 4. Install local package maps
cd core-parsers && pnpm install

# 5. Spin up localized development server watcher
pnpm dev

Note: All runtime cache, build outputs, and parser registry files compile safely into an isolated .dev-data/ folder which is .gitignore protected.

• License: Entirely open-source and distributed under the MIT License.
• Legal: Omu does not host, index, cache, or distribute copyrighted media files. It functions exclusively as a client-side shell mapping public endpoints and decentralized torrent swarms onto system players. All operations are local to the user's machine.