{"id":13907597,"url":"https://github.com/fabquenneville/MediaCurator","last_synced_at":"2025-07-18T06:30:29.060Z","repository":{"id":57440581,"uuid":"308825260","full_name":"fabquenneville/mediacurator","owner":"fabquenneville","description":"MediaCurator is a Python command line tool to manage and batch convert a media database to modern codecs like HEVC (x265).","archived":false,"fork":false,"pushed_at":"2024-10-30T06:33:46.000Z","size":1267,"stargazers_count":7,"open_issues_count":6,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-12T11:04:41.346Z","etag":null,"topics":["av1","codecs","filters","hevc","media-database","python-command","video","x265"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabquenneville.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-31T07:08:31.000Z","updated_at":"2024-12-30T22:25:32.000Z","dependencies_parsed_at":"2024-10-23T08:23:10.868Z","dependency_job_id":"380fc187-1d7e-467e-b94d-8c41b1760f6f","html_url":"https://github.com/fabquenneville/mediacurator","commit_stats":{"total_commits":126,"total_committers":1,"mean_commits":126.0,"dds":0.0,"last_synced_commit":"44bf4fef045435846853037fcd2623cb507bf5f7"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/fabquenneville/mediacurator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabquenneville%2Fmediacurator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabquenneville%2Fmediacurator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabquenneville%2Fmediacurator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabquenneville%2Fmediacurator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabquenneville","download_url":"https://codeload.github.com/fabquenneville/mediacurator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabquenneville%2Fmediacurator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265153236,"owners_count":23719144,"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":["av1","codecs","filters","hevc","media-database","python-command","video","x265"],"created_at":"2024-08-06T23:02:00.989Z","updated_at":"2025-07-18T06:30:28.668Z","avatar_url":"https://github.com/fabquenneville.png","language":"Python","funding_links":[],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"# mediacurator\n\nmediacurator is a Python command line tool to manage a media database.\n\n- List all the videos and their information with or without filters\n- Batch find and repair/convert videos with encoding errors\n- Batch recode videos to more modern codecs (x265 / AV1) based on filters: extensions, codecs, resolutions …\n\n## Documentation\n\nThe documentation is available on the following [link](https://fabquenneville.github.io/mediacurator/)\n\n## Releases\n\nmediacurator can be installed via the following methods:\n\n- APT repository for Debian/Ubuntu systems\n- PyPi using pip\n\nFor detailed installation instructions, please visit the following links:\n\n- [Installation Instructions](https://fabquenneville.github.io/mediacurator/usage/installation.html)\n- [APT Repository](https://debrepo.fabq.ca/)\n- [PyPi Page](https://pypi.org/project/mediacurator/)\n\n## Usage\n\n```bash\n    mediacurator \u003ccommand\u003e [options]\n\n    # Command options\n    mediacurator [list convert] [-del/--delete]\n        [-i/--inputs any 3gp asf avi divx dv f4v flv gif m2ts m4v mkv mov mp4 mpeg mpg mts ogm ogv rm swf ts vid vob webm wmv]\n        [-fl/--filters fferror old lowres hd 720p 1080p uhd mpeg mpeg4 x264 wmv3 wmv]\n        [-o/--outputs mkv/mp4 x265/av1]\n        [-p/--printop list formatted verbose]\n        [-d/--dirs \"/mnt/media/\" \"/mnt/media2/\"]\n        [-f/--files \"file1.ext\" \"file2.ext\"]\n```\n\n**Available commands:**\n\n- `list`: List all videos with specified filters.\n- `convert`: Convert videos to specified formats.\n\n**Options:**\n\n- `-del` or `--delete`: Delete found results after successful operations. **Use with caution**.\n- `-i \u003cinput\u003e` or `--inputs \u003cinput\u003e`: Specify input file formats (default: `any`).\n- `-fl \u003cfilter\u003e` or `--filters \u003cfilter\u003e`: Apply filters to the selection of videos.\n- `-o \u003coutput\u003e` or `--outputs \u003coutput\u003e`: Specify output formats (default: `mkv`, `x265`).\n- `-p \u003cprint_option\u003e` or `--printop \u003cprint_option\u003e`: Set print options (default: `list`).\n- `-f \u003cfile\u003e` or `--files \u003cfile\u003e`: Specify files to process.\n- `-d \u003cdirectory\u003e` or `--dirs \u003cdirectory\u003e`: Specify directories to process.\n\n**For multiple files or filenames, use space-separated values ( ).**\n\n**Default options (if not specified):**\n\n- `-i/--inputs`: `any`\n- `-fl/--filters`: (none)\n- `-o/--outputs`: `mkv`, `x265`\n- `-p/--printop`: `list`\n\n### Examples\n\n```bash\n# List all videos with old codecs in formatted output\nmediacurator list --filters old --printop formatted --dirs \"/mnt/media/\" \"/mnt/media2/\" \u003e\u003e ../medlist.txt\n\n# Convert all MPEG4 videos to AV1 in MP4 format, and delete originals after conversion\nmediacurator convert --delete --filters mpeg4 --outputs av1 mp4 --dirs \"/mnt/media/\" \"/mnt/media2/\"\n\n# Convert videos with AVI or MPG extensions, print formatted and verbose output, and delete originals\nmediacurator convert --delete --inputs avi mpg --printop formatted verbose --dirs \"/mnt/media/\" \"/mnt/media2/\"\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## License\n\n[GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabquenneville%2FMediaCurator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabquenneville%2FMediaCurator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabquenneville%2FMediaCurator/lists"}