{"id":22401735,"url":"https://github.com/bigsk1/yt-webui","last_synced_at":"2025-08-10T20:06:56.108Z","repository":{"id":266610004,"uuid":"823903285","full_name":"bigsk1/yt-webui","owner":"bigsk1","description":"A web-based user interface for yt-dlp, allowing easy video downloads from YouTube and other supported platforms.","archived":false,"fork":false,"pushed_at":"2025-07-19T22:33:52.000Z","size":2873,"stargazers_count":15,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-30T12:43:51.535Z","etag":null,"topics":["docker","docker-compose","fastapi","homelab","reactjs","self-hosted","tailwindcss","youtube","youtube-audio-downloader","youtube-dl","youtube-downloader","youtube-transcripts","youtube-video","yt-dlp","yt-dlp-gui"],"latest_commit_sha":null,"homepage":"https://bigsk1.com","language":"JavaScript","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/bigsk1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"github":"bigsk1"}},"created_at":"2024-07-04T01:21:01.000Z","updated_at":"2025-07-19T22:33:55.000Z","dependencies_parsed_at":"2024-12-05T07:02:46.975Z","dependency_job_id":"2768d3b9-924c-4ee8-9e20-3b9b433f435a","html_url":"https://github.com/bigsk1/yt-webui","commit_stats":null,"previous_names":["bigsk1/yt-webui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bigsk1/yt-webui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fyt-webui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fyt-webui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fyt-webui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fyt-webui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigsk1","download_url":"https://codeload.github.com/bigsk1/yt-webui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fyt-webui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269780617,"owners_count":24474686,"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-10T02:00:08.965Z","response_time":71,"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":["docker","docker-compose","fastapi","homelab","reactjs","self-hosted","tailwindcss","youtube","youtube-audio-downloader","youtube-dl","youtube-downloader","youtube-transcripts","youtube-video","yt-dlp","yt-dlp-gui"],"created_at":"2024-12-05T09:07:51.108Z","updated_at":"2025-08-10T20:06:56.082Z","avatar_url":"https://github.com/bigsk1.png","language":"JavaScript","funding_links":["https://github.com/sponsors/bigsk1"],"categories":[],"sub_categories":[],"readme":"# YT-DLP Web UI\n\nA web-based user interface for yt-dlp, allowing easy video downloads from YouTube and other supported platforms.\n\n\n![YT-WEBUI](https://imagedelivery.net/WfhVb8dSNAAvdXUdMfBuPQ/48ffe438-3815-432d-8947-8a1d361c1800/public)\n\n\n## Features\n\n- Download videos in various formats and qualities\n- Extract audio from videos\n- Download subtitles\n- User-friendly interface for yt-dlp options\n- Docker support for easy deployment\n\n## Prerequisites\n\n- Python 3.8+\n- Node.js 18+\n- FFmpeg\n- Docker and Docker Compose (for Docker deployment)\n\n## Installation\n\n\n## Quick Start\n\n1. Ensure you have [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) installed on your system.\n\n2. Clone this repository:\n   ```\n   git clone https://github.com/bigsk1/yt-webui.git\n   cd yt-webui\n   ```\n\n3. Start the application:\n   - On Unix-based systems (Linux, macOS):\n\n   - set permission to run using: \n\n     ```bash\n      chmod +x start.sh\n     ```\n\n     ```\n     ./start.sh\n     ```\n\n\n   - On Windows:\n     ```\n     start.bat\n     ```\n\n4. Open your web browser and navigate to `http://localhost:3000` to use the application.\n\n5. To stop the application:\n   - On Unix-based systems (Linux, macOS):\n\n   - set permission to stop using: \n\n      ```bash\n      chmod +x stop.sh\n      ```\n\n     ```\n     ./stop.sh\n     ```\n   - On Windows:\n     ```\n     stop.bat\n     ```\n\n\n### Local Development Setup\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/bigsk1/yt-webui.git\n   cd yt-webui\n   ```\n\n2. Install backend dependencies:\n   ```\n   pip install -r requirements.txt\n   ```\n\n3. Install frontend dependencies:\n   ```\n   npm install\n   ```\n\n4. Start the backend server:\n   ```\n   uvicorn main:app --reload\n   ```\n\n5. In a new terminal, start the frontend development server:\n   ```\n   npm start\n   ```\n\n6. Open your browser and navigate to `http://localhost:3000`\n\n### Docker Deployment\n\n1. Make sure you have Docker and Docker Compose installed on your system.\n\n2. Clone the repository:\n   ```\n   git clone https://github.com/bigsk1/yt-webui.git\n   cd yt-webui\n   ```\n\n3. Build and start the Docker containers:\n   ```\n   docker-compose up -d --build\n   ```\n\n4. Open your browser and navigate to `http://localhost:3000`\n\n\n## Use prebuilt docker images from github\n\nTo start\n\n```bash\ndocker-compose -f docker-compose.external.yml up -d\n```\n\nTo stop\n\n```bash\ndocker-compose -f docker-compose.external.yml down\n```\n\n\n## Usage\n\n1. Enter the URL of the video you want to download in the input field.\n2. Select your preferred download options (format, quality, etc.).\n3. Click the \"Download\" button to start the download process.\n4. The downloaded files will be saved in the specified output directory of Downloads in the docker folder, if using native app then in Downloads folder of windows user.\n\nOn windows if you want to link the Downloads directory of your docker container to your Windows Downloads location run in project root as command prompt admin\n\n```bash\nmklink /D \"%USERPROFILE%\\Downloads\\yt_downloads\" \"%CD%\\docker\\Downloads\"\n```\n\nor as Powershell admin\n\n```bash\nNew-Item -ItemType SymbolicLink -Path \"$env:USERPROFILE\\Downloads\\yt_downloads\" -Target \"$PWD\\docker\\Downloads\"\n```\n\nThen all your downloaded content will be in your windows Downloads folder in a yt_downloads folder\n\n\n## Docker Commands\n\n- Start the containers: `docker-compose up -d`\n- Stop the containers: `docker-compose down`\n- View logs: `docker-compose logs`\n- Rebuild and start the containers: `docker-compose up -d --build`\n\n\n## Notes\n\nI know the Downloads folder in the docker folder isn't ideal for most but do to windows permission issues with docker trying to map to users downloads folder is an issue, there is work that can be done to allow it but trying to make this setup easy for most users. Hence the double click scripts to get up and going. \n\nyou can also just symlink it but running this as admin in in command prompt the project folder\n\n```bash\nmklink /D \"%USERPROFILE%\\Downloads\\yt_downloads\" \"%CD%\\docker\\Downloads\"\n```\n\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsk1%2Fyt-webui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigsk1%2Fyt-webui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsk1%2Fyt-webui/lists"}