SeharaCloud

SeharaCloud is a powerful self-hosted media cloud system designed for seamless management of music, videos, documents, and images, completely free from advertisements. This platform allows users to store, access, and organize their media without relying on third-party services.

Key Features

• File Indexing and Metadata Storage: The media files are automatically indexed by a C++ daemon while metadata is efficiently stored in a PostgreSQL database. This ensures quick retrieval and management of media assets.
• Robust API: The REST API built using ASP.NET Core facilitates interaction with various frontend clients, enabling mobile apps and web interfaces to access the media library easily.
• Extensive File Lifecycle Management:
  1. Files arrive in a staging/ directory through methods like scp, rsync, or yt-dlp.
  2. A watcher captures events only after write operations are complete, ensuring data integrity.
  3. The FileProcessor handles calculations such as SHA-256 for deduplication, metadata extraction, and thumbnail generation.
  4. The files are then moved to a designated media directory, and relevant entries are created in the database.

Architecture Overview

flowchart LR
    A["scp / rsync / yt-dlp"] -->|write| B[("staging/")]
    B -->|"IN_CLOSE_WRITE / IN_MOVED_TO"| C["Watcher (inotify)"]
    C --> D["FileProcessor\nSHA-256 · TagLib · ffprobe · Poppler · Magick++"]
    D -->|INSERT metadata| E[("PostgreSQL")]
    D -->|move file| F[("media/ — physical")]
    G["ASP.NET Core API"] -->|SELECT| E
    G -->|"PhysicalFile + Range"| F
    H["Frontend / Mobile App"] -->|"REST"| G

Technology Stack

Mobile Application

The native Android app, SeharaCloud.MobileApp, utilizes Kotlin and Jetpack Compose, providing a unique user experience for browsing and playing media directly from a mobile device. Key features include:

• Live search and track organization by artists and genres.
• Dynamic playback options with a rich media player interface.
• Efficient document handling, including a built-in PDF viewer.
• Native image browsing with a structured photo viewer.

The app connects to the REST API, ensuring smooth communication and easy access to the powerful features of SeharaCloud, making media management on-the-go efficient and user-friendly.

For detailed documentation, including project structure, API endpoints, and customization options, refer to the project README. SeharaCloud aims to provide users with a comprehensive self-hosted solution for managing their media collections effectively.