Skip to content

lfglabs-dev/offline_cinema

Repository files navigation

Offline Cinema

Offline Cinema

Open source macOS video library. Beautiful. Minimal. Native.

Build it yourself · Features


What is this?

Offline Cinema is a native macOS application for managing and watching your local video library. Inspired by Apple Books, it provides a clean, minimal interface that feels right at home on macOS.

This project is fully open source. You can clone it, build it, modify it, and use it however you like.

  • Drag and drop videos to build your library
  • Track progress with automatic resume
  • Organize with custom collections
  • Full playback with keyboard controls and Picture-in-Picture

Screenshots

Library View

Video Player

Picture-in-Picture

Fullscreen Playback

Features

Feature Description
Smart Filters All, Watching, Finished – automatically organized
Collections Create custom collections with icons and colors
Progress Tracking Automatically saves your position and watch state
Picture-in-Picture Watch in a floating window while you work
Keyboard Shortcuts Space, arrows, F for fullscreen

Supported Formats

Video Formats
MP4, MOV, MKV, AVI, M4V, WebM, WMV, FLV, 3GP, OGV

Requirements

  • macOS 14.0+

Building

Quick Build

./build-app.sh

This will:

  1. Build the app in release mode
  2. Create the OfflineCinema.app bundle
  3. Launch the app automatically

Clean Rebuild

If you need to rebuild from scratch:

swift package clean && rm -rf .build OfflineCinema.app && ./build-app.sh

Build with Xcode

Alternatively, open OfflineCinema.xcodeproj in Xcode and build from there.

Running the App

After Building

The build script automatically launches the app. To run it manually:

open OfflineCinema.app

Move to Applications (Optional)

cp -r OfflineCinema.app /Applications/

Keyboard Shortcuts

Key Action
Space Play / Pause
Skip back 10s
Skip forward 30s
/ Volume
F Fullscreen
Esc Exit player
⌘O Import video

Project Structure

offline_cinema/
├── OfflineCinema/
│   ├── Models/           # Video, Collection, WatchProgress
│   ├── Services/         # VideoLibrary, Persistence, Thumbnails
│   ├── Views/            # SwiftUI views
│   └── Assets.xcassets/  # App icons and colors
├── build-app.sh          # Build script
└── Package.swift         # Swift Package Manager config

Data Storage

Your library data is stored in:

~/Library/Application Support/OfflineCinema/

Videos are not copied – only references (bookmarks) are stored.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published