{"id":30047395,"url":"https://github.com/lucianodato/makeitdrumless","last_synced_at":"2025-08-07T09:48:13.658Z","repository":{"id":307551365,"uuid":"1029295663","full_name":"lucianodato/MakeItDrumless","owner":"lucianodato","description":"A Python script to automate downloading a YouTube song, removing drums, and generating a backing track for practice or performance.","archived":false,"fork":false,"pushed_at":"2025-07-31T19:38:40.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-31T22:41:37.733Z","etag":null,"topics":["drumless","drums","music-separation"],"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/lucianodato.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,"zenodo":null}},"created_at":"2025-07-30T20:25:28.000Z","updated_at":"2025-07-30T20:36:24.000Z","dependencies_parsed_at":"2025-07-31T22:41:40.895Z","dependency_job_id":"43293030-3244-4697-95f9-ffc0f50d58d9","html_url":"https://github.com/lucianodato/MakeItDrumless","commit_stats":null,"previous_names":["lucianodato/makeitdrumless"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/lucianodato/MakeItDrumless","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianodato%2FMakeItDrumless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianodato%2FMakeItDrumless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianodato%2FMakeItDrumless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianodato%2FMakeItDrumless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucianodato","download_url":"https://codeload.github.com/lucianodato/MakeItDrumless/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianodato%2FMakeItDrumless/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269236465,"owners_count":24383230,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["drumless","drums","music-separation"],"created_at":"2025-08-07T09:48:12.751Z","updated_at":"2025-08-07T09:48:13.625Z","avatar_url":"https://github.com/lucianodato.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MakeItDrumless\n\nThis project allows you to generate drumless tracks from YouTube videos using the SCNet model.\n\n## Project Structure\n\n```\nMakeItDrumless/\n├── .git/\n├── .gitignore\n├── README.md\n├── requirements.txt\n├── checkpoints/ (SCNet model checkpoints)\n├── ffmpeg/ (Portable FFmpeg binaries)\n├── SCNet/ (SCNet repository - external, for inference)\n├── src/\n│   ├── __init__.py\n│   ├── audio/\n│   │   ├── __init__.py\n│   │   ├── downloader.py (Handles YouTube audio download)\n│   │   └── processing.py (Handles audio mixing and metadata)\n│   ├── ffmpeg/\n│   │   ├── __init__.py\n│   │   └── manager.py (Manages FFmpeg installation)\n│   ├── scnet_integration/\n│   │   ├── __init__.py\n│   │   ├── inference.py (Integrates SCNet inference logic)\n│   │   └── repo_manager.py (Manages SCNet repository and checkpoints)\n│   └── utils/\n│       ├── __init__.py\n│       └── spinner.py (Utility for console spinner)\n└── temp/ (Temporary files)\n└── output/ (Generated drumless tracks)\n```\n\n## Setup\n\n1.  **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/your_username/MakeItDrumless.git\n    cd MakeItDrumless\n    ```\n\n2.  **Create and activate a virtual environment:**\n\n    ```bash\n    python -m venv .venv\n    # On Windows\n    .venv\\Scripts\\activate\n    # On macOS/Linux\n    source .venv/bin/activate\n    ```\n\n3.  **Install dependencies:**\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n4.  **Initial Setup (FFmpeg and SCNet Model):**\n\n    The first time you run `main.py`, it will automatically:\n    *   Download and set up a portable FFmpeg (Windows only, otherwise requires manual installation).\n    *   Clone the SCNet repository into the `SCNet/` directory.\n    *   Check for the SCNet model checkpoint (`SCNet-large.th`) and configuration file (`config.yaml`) in the `checkpoints/` directory. You will be prompted to manually download the checkpoint if it's missing.\n\n## Usage\n\nTo generate a drumless track from a YouTube video, run the `main.py` script with the YouTube URL as an argument:\n\n```bash\n.venv\\Scripts\\python.exe src/main.py \"\u003cYouTube_URL\u003e\"\n```\n\n**Example:**\n\n```bash\n.venv\\Scripts\\python.exe src/main.py \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"\n```\n\n## Output\n\nThe generated drumless track (MP3 format) will be saved in the `output/` directory. Separated stems (vocals, bass, other) will be saved in `separated_scnet/\u003cvideo_title\u003e/`.\n\n## Troubleshooting\n\n*   **FFmpeg not found:** If you are not on Windows, ensure FFmpeg is installed and added to your system's PATH.\n*   **SCNet Checkpoint Missing:** Follow the instructions in the console to manually download the `SCNet-large.th` file.\n*   **Dependency Issues:** Ensure all packages in `requirements.txt` are installed.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucianodato%2Fmakeitdrumless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucianodato%2Fmakeitdrumless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucianodato%2Fmakeitdrumless/lists"}