{"id":16554741,"url":"https://github.com/owez/mkplay","last_synced_at":"2025-10-24T12:41:38.674Z","repository":{"id":115272527,"uuid":"326085017","full_name":"Owez/mkplay","owner":"Owez","description":"Extendible video playlist visualiser","archived":false,"fork":false,"pushed_at":"2021-01-02T16:18:02.000Z","size":722,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-15T06:13:06.757Z","etag":null,"topics":["audio","music","playlist","visualiser","youtube"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Owez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2021-01-02T01:11:48.000Z","updated_at":"2021-01-02T16:18:04.000Z","dependencies_parsed_at":"2023-03-15T15:15:14.081Z","dependency_job_id":null,"html_url":"https://github.com/Owez/mkplay","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/Owez%2Fmkplay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Owez%2Fmkplay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Owez%2Fmkplay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Owez%2Fmkplay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Owez","download_url":"https://codeload.github.com/Owez/mkplay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241915347,"owners_count":20041745,"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":["audio","music","playlist","visualiser","youtube"],"created_at":"2024-10-11T19:52:13.153Z","updated_at":"2025-10-24T12:41:38.602Z","avatar_url":"https://github.com/Owez.png","language":"Python","readme":"# mkplay\n\nExtendible video playlist visualiser\n\n## In action\n\n- Real world usage: [Link](https://www.youtube.com/watch?v=Sl3XgtKYq4E)\n\nLocal screenshots:\n\n![Player image 1](./examples/eg1.png)\n![Player image 2](./examples/eg2.png)\n![Command-line use](./examples/eg3.png)\n\n## About\n\nOnce music is added to the `music/` directory beside the script, you may run `mkplay.py` and it will automatically generate a mp4 playlist video for you, containing all the songs from the directory like magic 🌠\n\nThis script was designed to handle many naming conventions so `THIS.IS-A VALID   name.mp3` is easily understood. Metadata helps the process and is automatically picked up but in order to keep a specific ordering of a playlist, you may use `0`, `1`, `2`, etc at the start of the tracks (as long as the metadata does not contain this).\n\nPlease note that an internet connection is required to use this script as it uses my local [tagzen](https://github.com/owez/tagzen) instance for better quality song metadata.\n\n## Installation\n\nTo install mkplay, you need to first install [ffmpeg](https://ffmpeg.org/) along with [python](https://www.python.org/) and the [pipenv](https://pipenv.pypa.io/en/latest/) package.\n\nOnce these are installed, you may clone this repository and run `pipenv install` to install the required dependencies this script needs and then simply:\n\n```shell\n$ pipenv run python mkdata.py\n```\n\nNote that you also need to populate the `music/` folder with music and have an image at hand if you'd like to put it in the background!\n\n## Customizing\n\nIf you'd like to customize the positioning of any of the video elements or change the default directories, you may edit the simple-to-use variables at the top of the `mkplay.py` script. Don't worry, it doesnt bite!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowez%2Fmkplay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fowez%2Fmkplay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowez%2Fmkplay/lists"}