Skip to main content

Command Line Media Browser

Project description

cmdia - Command Line Media Browser

cmdia is a dead simple CLI media browser for local video files. It is designed for the following situation:

  • You have very limited input methods (no mouse and no full keyboard, only for example a TV remote)
  • All of your files are organized in directories
  • You don't need any features (nice UI, search, metadata, images, online connectivity, none of all that)

What it actually does:

  • Navigate files with Up/Down arrows
  • Play video files with Enter (mpv by default)
  • Remembers where you left off and what you already watched

Installation

Works on Linux, maybe works on macOS, probably doesn't work on Windows. Needs python3.

$ pip install cmdia

Usage

$ cmdia
  • Up/Down arrows: Navigation
  • Enter: Enter directory or play file
  • Esc: Go to parent directory
  • q: Quit

To change the media player used (default mpv), edit the following file (gets created on first startup):

$ ~/.config/cmdia/config.yaml

The media_player section is a list of the media player command and its arguments. For example:

media_player:
- "vlc"
- "--fullscreen"
- "--loop"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cmdia-1.0.0.tar.gz (17.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cmdia-1.0.0-py3-none-any.whl (19.2 kB view details)

Uploaded Python 3

File details

Details for the file cmdia-1.0.0.tar.gz.

File metadata

  • Download URL: cmdia-1.0.0.tar.gz
  • Upload date:
  • Size: 17.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for cmdia-1.0.0.tar.gz
Algorithm Hash digest
SHA256 fb55b22b53752799428b9d0439b2a3c8e14b85a7b29e36fad10f6e27ee35e2aa
MD5 0a7ad86a71feee629ae69a54e731e5cc
BLAKE2b-256 08b46510c7b99d6e49d0ac525eb35a4256eca5583184e7e138af4e18c6dbef3e

See more details on using hashes here.

File details

Details for the file cmdia-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: cmdia-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 19.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for cmdia-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d26717a351a4585807b19a411b565919106c81dce2e120bdcca640615b536687
MD5 cc397ab3821e76258cb47065857beed1
BLAKE2b-256 dff911f593875c3d950042d8ef29438a2dc54b5d1c52b47cc321b2d654f9b5b3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page