Skip to content
/ c-cli Public

🎬 Movie browser - TUI and Web app for browsing and downloading movies/tv

License

Notifications You must be signed in to change notification settings

jgbrwn/c-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

24 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎬 C-CLI - Movie & TV Show Browser

A Go application for browsing and downloading movies and TV shows. Available as both a terminal UI (TUI) and a web app.

Inspired by cinecli by @eyeblech.

✨ Features

  • πŸ” Multiple search sources:
    • YTS - High quality movie torrents
    • Torrents-CSV - General torrents (movies, TV shows, and more)
  • πŸŽ¬πŸ“Ί View detailed movie & TV show information (enriched with IMDB data via OMDB)
  • πŸ“Ί TV Show Support - Automatic detection of TV series with season counts, episode runtimes, creators
  • πŸ“Š Search results sorted by IMDB popularity
  • πŸ“„ Pagination - Navigate through large result sets
  • 🧲 Generate magnet links
  • πŸ“¦ Download .torrent files
  • ⚑ Auto-select best torrent (highest quality + healthy seeds)
  • πŸ–₯ Cross-platform (Linux, macOS, Windows, FreeBSD)

πŸ’» TUI Version

Terminal-based interface built with Bubble Tea.

Build & Run

go build -o c-cli .

# With OMDB API key (recommended - enables ratings, cast, plot, sorted by popularity)
OMDB_API_KEY=your_key ./c-cli

# Without OMDB (basic mode)
./c-cli

Screenshot

🎬 CineCLI - Movie Browser

πŸ” Search for movies:

> inception

Keyboard Controls

Key Action
↑/↓ or j/k Navigate lists
←/β†’ or [/] Previous/Next page (search results)
Enter Select / Show magnet link
0-9 Select torrent by index
Tab Switch source (search) / Switch sections
Esc Go back
a Auto-select best torrent
m Show magnet link
t Download .torrent file
Ctrl+C Quit

Configuration

Create ~/.config/c-cli/config.toml:

search_limit = 50
download_dir = "~/Downloads"
omdb_api_key = "your_key_here"  # Optional, or use OMDB_API_KEY env var
search_source = "yts"           # "yts" or "torrents-csv"

With OMDB enabled:

  • Search results sorted by IMDB popularity (vote count)
  • Full movie/TV show details: rating, runtime, director/creator, cast, plot
  • TV shows display season count and episode runtime
  • IMDB ratings instead of YTS ratings

Search sources:

  • yts - High quality movie torrents (default)
  • torrents-csv - General torrents including TV shows

🌐 Web Version

Web-based interface with OMDB/IMDB integration for rich movie and TV show metadata.

Screenshot

Build & Run

cd c-cli-web
go build -o c-cli-web .

# With OMDB API key (recommended - enables posters, ratings, cast, plot)
OMDB_API_KEY=your_key ./c-cli-web

# Without OMDB (basic mode)
./c-cli-web

Then open http://localhost:8000

Features

  • πŸ” Multiple search sources: YTS (movies) or Torrents-CSV (all)
  • πŸŽ¬πŸ“Ί Movie and TV show posters in search results and details
  • πŸ“Ί TV Show Support:
    • Automatic detection of TV series vs movies
    • Season count display
    • Episode runtime
    • Creator information (instead of director)
    • Series type badges in search results
  • ⭐ IMDB ratings, runtime, genres, director/creator, cast
  • πŸ“Š Results sorted by IMDB popularity
  • πŸ“ Full plot descriptions
  • 🧲 Magnet links with copy to clipboard
  • ⬇ Download .torrent to server
  • πŸ’Ύ Download .torrent to your browser
  • 🧲 Torrent Cache Integration - Fetches .torrent files from cache services for Torrents-CSV
  • πŸ”— Click poster to open IMDB page
  • πŸŒ™ Dark theme UI

Environment Variables

Variable Default Description
PORT 8000 Server port
HOST 127.0.0.1 Bind address
DOWNLOAD_DIR $HOME Server download directory
OMDB_API_KEY (none) Get free key

See c-cli-web/README.md for full documentation.


πŸ›  Tech Stack

  • Go - Programming language
  • Bubble Tea - TUI framework
  • Lip Gloss - TUI styling
  • YTS API - Movie/torrent data
  • Torrents-CSV API - General torrent search
  • OMDB API - IMDB metadata (optional, both versions)

πŸ“„ License

Apache License 2.0 - see LICENSE and NOTICE for details.

About

🎬 Movie browser - TUI and Web app for browsing and downloading movies/tv

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published