whatisgithub

What is cinema-manager?

davidbb-l/cinema-manager — explained in plain English

Analysis updated 2026-05-18

26PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

In one sentence

A Python skill for the Hermes Agent framework that searches for movies and shows, scores result quality, and saves the best one to a Quark cloud drive, sorted by genre.

Mindmap

mindmap
  root((cinema manager))
    What it does
      Multi source search
      Quality scoring
      Save to Quark drive
    Tech stack
      Python
      Hermes Agent
      OMDB API
    Use cases
      Find and save media
      Sort by genre
      Add new plugins
    Audience
      Media server users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search multiple sources for a movie or show and save the best quality result to Quark

USE CASE 2

Automatically sort saved media into genre folders for use with Plex, Jellyfin, or Infuse

USE CASE 3

Compare search results by resolution, source type, and codec before choosing one

USE CASE 4

Add a new content source by writing a small plugin file

What is it built with?

PythonHermes AgentOMDB API

How does it compare?

davidbb-l/cinema-manageraevella/sky-pc-mcp-companionalicankiraz1/gemma-4-31b-mtp-vllm-server
Stars262626
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencegeneralvibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Setup wizard and commands are in Chinese, requires a Quark account and the Hermes Agent framework.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Cinema Manager is a Python skill for the Hermes Agent framework that helps users find movies and TV shows online and save them directly to a Quark cloud drive account. Quark is a Chinese cloud storage service, and the project is primarily aimed at Chinese-speaking users, with the setup wizard and agent commands written in Chinese. The skill integrates with media server software such as Infuse, Plex, and Jellyfin by saving files in a folder structure and naming convention those tools expect. The core features are a multi-source search system built on a plugin architecture, automatic quality scoring for each search result, and one-click saving to Quark. When results are saved, the skill can also classify them by genre using either the OMDB movie database API or scraping from the content source itself, then sort them into named folders like Action, Drama, or Sci-Fi inside the Quark drive. Quality scoring compares results across resolution (up to 4K), source type (Blu-ray remux down to camera recordings), HDR format, audio codec, video codec, subtitle availability, and which platform hosts the file. The result with the highest score is shown first. Genre results are cached locally to avoid repeated lookups. The plugin system lets users add new content sources by dropping a Python file into the plugins folder and implementing a search method and a link extraction method. An example plugin file is included. Configuration lives in a config.json file created during setup, and it stores Quark login credentials (username and password, or a session cookie), which plugins are enabled, the target save folder name, and an optional OMDB API key. Installation requires cloning the repository into the Hermes skills folder and running a setup script. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through setting up the config.json file with my Quark login and OMDB API key.
Prompt 2
Explain how the quality scoring system ranks search results.
Prompt 3
Show me how to write a new plugin that adds another content source.
Prompt 4
How does this skill organize saved files for Plex or Jellyfin to recognize them?

Frequently asked questions

What is cinema-manager?

A Python skill for the Hermes Agent framework that searches for movies and shows, scores result quality, and saves the best one to a Quark cloud drive, sorted by genre.

What language is cinema-manager written in?

Mainly Python. The stack also includes Python, Hermes Agent, OMDB API.

What license does cinema-manager use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is cinema-manager to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cinema-manager for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.