{"id":16569259,"url":"https://github.com/kevinleeex/dj-beat","last_synced_at":"2025-03-21T11:33:43.902Z","repository":{"id":37597940,"uuid":"171203486","full_name":"kevinleeex/dj-beat","owner":"kevinleeex","description":"A tool for beat tracking, ready for FCPX and Premiere.","archived":false,"fork":false,"pushed_at":"2024-05-03T19:44:10.000Z","size":13168,"stargazers_count":20,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-18T01:07:06.522Z","etag":null,"topics":["beat-tracking","fcpx"],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","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/kevinleeex.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":"2019-02-18T02:48:57.000Z","updated_at":"2025-03-16T23:03:47.000Z","dependencies_parsed_at":"2024-10-28T10:24:08.712Z","dependency_job_id":"428fd513-3d99-4189-9016-1fa2edc4afda","html_url":"https://github.com/kevinleeex/dj-beat","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/kevinleeex%2Fdj-beat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinleeex%2Fdj-beat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinleeex%2Fdj-beat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinleeex%2Fdj-beat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinleeex","download_url":"https://codeload.github.com/kevinleeex/dj-beat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244792344,"owners_count":20511121,"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":["beat-tracking","fcpx"],"created_at":"2024-10-11T21:12:53.307Z","updated_at":"2025-03-21T11:33:42.862Z","avatar_url":"https://github.com/kevinleeex.png","language":"Jupyter Notebook","funding_links":["https://paypal.me/kevinleeex"],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\u003cimg style=\"display:inline-block\" width='150' src=\"./assets/logo.png\"/\u003e\u003cp\u003e\n    \u003cspan style=\"font-size: 14px\"\u003eVersion: 0.4.9\u003c/span\u003e\u003cbr\u003e\n    \u003cspan\u003e\"A Simple Beat Time Marks Generator\"\u003c/span\u003e\u003cbr\u003e\n    \u003cspan style=\"font-size: 12px;color= #95dafc\"\u003e-- Created by \u003ca\u003eKevin T. Lee\u003c/a\u003e --\u003c/span\u003e\n    \u003c/p\u003e\n    \u003ca href=\"./LICENSE\"\u003e\u003cimg alt=\"MIT\" src=\"https://img.shields.io/github/license/mashape/apistatus.svg?\u0026url=LICENSE\u0026longCache=true\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n        \u003ca href=\"http://lidengju.com\"\u003e\u003cimg alt=\"Code\" src=\"https://img.shields.io/badge/Code%20with-Love-red.svg?longCache=true\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/kevinleeex/dj-beat/\"\u003e\u003cimg alt=\"Version\" src=\"https://img.shields.io/badge/Version-0.4.9-blue.svg?longCache=true\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n# DJ-beat\n\nDj-beat is an easy-to-use generator that automatically detects audio beats and generates time markers for FCPX and Adobe Premiere*.\n\n\u003e P.S. why the tool is called DJ beat? DJ is from my chinese first name of course...\n\n## :headphones: Overview\n\nA good music-driven video requires a perfect combination of sound and picture. Think about you're using the video editing software like Final Cut Pro X, you need to manually mark the place on the soundtrack that denotes the beat. Now, you have the **DJ-beat**, which can help you handle such a boring thing, mark, mark, mark...While it may do better than us. \n\nDj-beat is a simple tool developed based on python3 and madmom library, supports operating via command line and graphical interface*. The principle of the tool is the music beat tracking (based on multi-LSTM models and Dynamic Bayesian Network), then the tool output the XML file, which the FCPX and PRE can read.\n\nLearn more about **beat tracking**:\n\n- for Chinese readers click [here](https://github.com/kevinleeex/dj-beat/blob/master/post/beat_tracking_in_mir.ipynb). \n\n- for English readers click [here](https://www.analyticsvidhya.com/blog/2018/02/audio-beat-tracking-for-music-information-retrieval/).\n\n### Preview\n\n![preview](./assets/preview.png)\n\n## :beer: Installation \n### Requirements\nCython==0.29.6  \nnumpy==1.14.3\n\u003e You may need to install the above two libs before you install the dj-beat.\n\nmadmom==0.16.1  \ntqdm==4.31.1  \nlibrosa==0.6.3  \n\n```bash\ncd ./djbeat\npip install -r bases.txt  \npip install -r requirements.txt\n```\n\n### Use pip (Recommended)\n\u003e make sure you have add your virtual environment **bin** path to the PATH, thus to use the command line tool.\n \n```bash\npip install dj-beat\n```\n\n### Locally\n\n```bash\n$ git clone https://github.com/kevinleeex/dj-beat.git\n$ cd dj-beat\n$ pip setup.py install\n```\n\n## :star2: Usage\n\n### Command-Line Tool\n\n```bash\n$ djbeat -f ./test/treasure-trimed.wav -r 30\n```\n\n#### Arguments\n\n```\n-h, --help           Display this help message and exit.\n-v,                  Display the version.\n-V,                  Display the beat time list in terminal.\n-p, --platform       The platform, fcpx or pre, default='fcpx'.\n-f, --filepath       The filepath of the input audio.\n-s, --fps FPS        The sample rate of the music, a integer number, default='100'.\n-r, --frame_rate     The frame rate of your video setting, choose from {23.98,24,25,29.97,30,50,60}, default='30'.\n```\n\n### Graphic User Interface\n\n[TO-DO]\n\n## :heart: Support me\n\nIf this project helps you, you can support me to do better.  \n\u003ca href=\"https://paypal.me/kevinleeex\"\u003e\u003cimg alt=\"Coffee\" src=\"https://img.shields.io/badge/PayPal_me_a-Coffee-7A501E.svg?longCache=true\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\nOr click \u003ca href=\"http://lidengju.com/donate\"\u003eDonete me\u003c/a\u003e with Wechat or Alipay\n\n## :zzz: TO-DO\n\n- [x] Distribution\n- [ ] Support the GUI\n- [ ] Support generate marks for PRE\n- [ ] Model research about beat tracking\n\n\n## :paperclip: License\n\nCopyright © 2018 [Kevin T. Lee](http://lidengju.com). All rights reserved. \n\nThe project is licensed under the MIT license. See [LICENSE](./LICENSE) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinleeex%2Fdj-beat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinleeex%2Fdj-beat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinleeex%2Fdj-beat/lists"}