{"id":15890105,"url":"https://github.com/hph/mov","last_synced_at":"2025-04-02T17:15:11.209Z","repository":{"id":8971199,"uuid":"10713870","full_name":"hph/mov","owner":"hph","description":"Browse your movie collection via a command-line interface.","archived":false,"fork":false,"pushed_at":"2013-07-04T23:40:33.000Z","size":260,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-09T10:04:21.426Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"hph.is/probased","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-06-16T00:39:24.000Z","updated_at":"2013-12-14T15:08:13.000Z","dependencies_parsed_at":"2022-09-26T17:20:27.269Z","dependency_job_id":null,"html_url":"https://github.com/hph/mov","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hph%2Fmov","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hph%2Fmov/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hph%2Fmov/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hph%2Fmov/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hph","download_url":"https://codeload.github.com/hph/mov/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246856689,"owners_count":20844974,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-06T07:03:29.392Z","updated_at":"2025-04-02T17:15:11.187Z","avatar_url":"https://github.com/hph.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"mov\n===\n\n**mov** is a command-line application to browse your movie collection.\n\n* List movies: `mov ls | less`\n* List specific movies: `mov ls the godfather`\n* Play a movie: `mov play the godfather`\n\n## Setup\n\nYou can run the following command to download and install **mov** on a Unix\nsystem. \n\n    bash \u003c(wget -qO- https://raw.github.com/hph/mov/master/setup.sh)\n\n## Usage\n\nWe will assume that `~/Movies` is a directory containing subdirectories,\nthemselves containing movies and related files, e.g., running `tree ~/Movies`\nshould show something like this:\n    \n    ~/Movies\n    ├── 12 Angry Men\n    │   └── 12 Angry Men.mkv\n    ├── 2001 - A Space Odyssey\n    │   └── 2001 - A Space Odyssey.mkv\n    ...\n\nFirst you will have to create a database of your movies:\n\n    mov create ~/Movies\n\nNow watch a movie:\n\n    mov play odyssey\n\nRun `mov -h` to show what else you can do.\n\n## Unix trickery\n\n**mov** is desinged in such a way as to be usable with standard Unix utilities.\n\n* Run `mov ls | less` to browse a large number of movies more comfortably. You\n  can use `j` to go down and `k` to go up. Use `/pattern` to search for a\n  movie.\n* Run `mov ls --name | wc -l` to count the number of movies in your database.\n* Run `mov ls | grep pattern` to search for \"pattern\".\n* Run `mov ls -S --prefix G | awk '{s += $1} END {print s}'` to show the\n  total size of the movie collection in gibibytes.\n\n## Available commands and options\n\n    Usage:\n      mov create [options] DIRECTORY ...\n      mov update [options] DIRECTORY ...\n      mov destroy [options]\n      mov ls [options] [PATTERN ...]\n      mov play [options] [PATTERN ...]\n      mov -h | --help\n      mov --version\n\n    Commands:\n      create               Create a new database with information about the films\n                           in the specified directory or directories.\n      update               Update an existing database. Old items that are not\n                           found are deleted.\n      destroy              Destroy a database.\n      ls                   List movies and relevant metadata optionally only\n                           showing those that match a specified pattern.\n      play                 Open the first matching movie with a media player.\n\n    Options:\n      --database=DATABASE  Database to save film metadata [default: ~/.mov.db].\n      --force              Do not prompt for a confirmation upon database\n                           destruction.\n      -s, --strict         Only show exact matches.\n      -n, --name           Only show the name of the movie.\n      -l, --location       Only show the location of the movie.\n      -S, --size           Only show the size of the movie.\n      -f, --files          Only show the files of the movie.\n      --prefix=PREFIX      Size prefix, one of none, k, M, G or T [default: None].\n      --player=PLAYER      Media player to open movies with [default: vlc].\n      -h, --help           Show this help message and exit.\n      --version            Show version.\n\n## To do\n\n* Improve the way data is displayed.\n* Use IMDbPy to retrieve information about movies.\n* Allow marking movies as seen or unseen.\n* Add rating movies.\n* Implement a watchlist (mark as \"watch this\").\n* Use SQLAlchemy to build a movies model for a better API.\n* Search for and get magnet to download movies.\n* Show statistics: number of movies, total size, formats, etc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhph%2Fmov","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhph%2Fmov","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhph%2Fmov/lists"}