Media Server • Nuxt 3 • Nitro

ClyoCloud Media & File Organizer

A database-free personal cloud storage tool built to organize image and video libraries using tags, collections, and sidecar JSON metadata.

Installation View Gallery Documentation
ClyoCloud Iconmedia_item.mp4.cloudinfo
Sidecar Metadata
{
"filename": "recording_2026.mp4",
"tags": ["video", "vacation", "favorites"],
"collection": "Summer 2026",
"favorite": true,
"description": "4K video clip",
"public_share": { "enabled": true }
}
Zero database administration100% file portability
Media Management Architecture

Tags, Collections & Sidecar Metadata

ClyoCloud is designed primarily to store, categorize, and stream image and video libraries. Instead of maintaining a centralized database engine, metadata is written to sidecar JSON files (<filename>.cloudinfo) located directly alongside target files.

Tagging System

Organize images and videos with custom tags for fast filtering.

Collections & Favorites

Group assets into curated collections and star key files for quick access.

In-Memory Tag Index

Rebuilds a fast in-memory tag cache on startup for instant search lookups.

Technical Specs

System Features

Image & Video Tagging

Attach tags and descriptions to media files. Metadata is written directly to the adjacent .cloudinfo file.

HTTP Range Video Server

Serves video content with HTTP 206 range-request headers for seamless seeking and video scrubbing in browsers and apps.

FFmpeg Preview Generation

Background task queue spawns FFmpeg and FFprobe processes to generate image and video thumbnails on demand.

Public Share Links

Generate unauthenticated share tokens for individual files to allow direct previews or downloads.

JWT Cookie Auth & TOTP 2FA

Session tokens are passed via secure cookies with optional TOTP Two-Factor Authentication.

Remote Media Downloader

Integrates yt-dlp as a background process to fetch remote videos directly to your storage directory.

Mobile Clients

Android Integration

ClyoCloud Android Icon

ClyoCloud Android

Mobile Media & File Viewer

Android client for browsing media libraries, viewing tag collections, and streaming video files.

RepositoryDownload APK
ClyoWallpaper Icon

ClyoWallpaper

Wallpaper Collection Sync

Synchronizes with cloud wallpaper collections and updates Android system/lockscreen wallpapers on a schedule.

RepositoryDownload APK
Device Token Authentication (QR Flow)

Scanning the QR code in settings registers a device token in devices.json. Active mobile sessions can be audited and revoked individually.

Deployment

Installation Methods

Arch Linux (AUR)

Install ClyoCloud directly from the Arch User Repository.

yay -S clyocloudStable
yay -S clyocloud-gitGit Latest

Generic Linux / Node.js

Build and execute the production server bundle on any host with Node.js 18+ and FFmpeg.

# Clone & build production server
git clone https://code.weexnes.dev/ClyoCloud
cd ClyoCloud && npm install && npm run build
node .output/server/index.mjs

Environment Configuration (.env)

PORT=6969
STORAGE_PATH=/path/to/media/storage
THUMBNAIL_PATH=/path/to/thumbnails
JWT_SECRET=your_secure_random_key