{"id":26211675,"url":"https://github.com/kernferm/bubbles-cloud-converter","last_synced_at":"2025-08-10T10:13:18.208Z","repository":{"id":281794969,"uuid":"946414760","full_name":"KernFerm/Bubbles-Cloud-Converter","owner":"KernFerm","description":"Bubbles Cloud Converter is a robust, web-based file conversion platform built to provide local, secure, and GPU-accelerated file conversion services. This tool processes various file types quickly and efficiently through a modern Flask-based interface.","archived":false,"fork":false,"pushed_at":"2025-08-08T01:10:44.000Z","size":15603,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-08T03:12:35.033Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://discord.fnbubbles420.org/invite","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KernFerm.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-11T05:21:15.000Z","updated_at":"2025-08-08T01:10:48.000Z","dependencies_parsed_at":"2025-08-08T03:09:13.950Z","dependency_job_id":"d3993096-ab7e-4f24-b13e-ac73db3a55c6","html_url":"https://github.com/KernFerm/Bubbles-Cloud-Converter","commit_stats":null,"previous_names":["kernferm/bubbles-cloud-converter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KernFerm/Bubbles-Cloud-Converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-Cloud-Converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-Cloud-Converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-Cloud-Converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-Cloud-Converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KernFerm","download_url":"https://codeload.github.com/KernFerm/Bubbles-Cloud-Converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-Cloud-Converter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269708071,"owners_count":24462520,"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":[],"created_at":"2025-03-12T08:28:37.886Z","updated_at":"2025-08-10T10:13:18.201Z","avatar_url":"https://github.com/KernFerm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bubbles Cloud Converter 🫧☁️\r\n\r\n**Bubbles Cloud Converter** is a robust, web-based file conversion platform built to provide local, secure, and GPU-accelerated file conversion services. This tool processes various file types quickly and efficiently through a modern Flask-based interface.\r\n\r\n---\r\n\r\n\r\n## 🌟 Features\r\n\r\n- **Convert a wide range of file types:**  \r\n  Supports images (`PNG`, `JPEG`, `BMP`, `GIF`, `TIFF`), audio (`MP3`, `WAV`, `FLAC`, `OGG`, `AAC`), video (`MP4`, `AVI`, `MKV`, `MOV`, `WMV`, `MPEG/MPG`), and documents (`DOC`, `DOCX`, `ODT`, `TXT`, `HTML`, `MD`, `PDF`, `XLS`, `XLSX`, `PPT`, `PPTX`, `CSV`).\r\n\r\n- **Custom output filenames:**  \r\n  Rename your converted files to whatever you like.\r\n\r\n- **Compression Options:**  \r\n  Includes standard and advanced compression for images, audio, and video.\r\n\r\n- **MIME Type Verification:**  \r\n  Ensures uploaded file content matches its extension using `python-magic`.\r\n\r\n- **GPU Acceleration Support:**  \r\n  Utilizes **NVIDIA (CUDA)** and **AMD (DirectML)** for faster video conversions.\r\n\r\n- **Secure Web Interface:**  \r\n  Simple drag-and-drop UI built with Bootstrap, secured with a user-defined secret key.\r\n\r\n---\r\n\r\n## 📋 Requirements\r\n\r\n- **Python 3.11.9**\r\n- **FFmpeg** (required by pydub/moviepy – installed via Chocolatey or manually)\r\n- Python packages:\r\n  - Flask\r\n  - Pillow\r\n  - pydub\r\n  - moviepy\r\n  - pypandoc\r\n  - python-magic\r\n  - werkzeug\r\n  - torch==2.8.0\r\n  - torch-directml==0.2.5.dev240914 *(required for AMD GPU support)*\r\n\r\n---\r\n\r\n## 🛠 Installation (Windows)\r\n\r\n## 📥 How to Download the Repo (First-Time Users)\r\n\r\nClick the link to read [**Instructions**](https://www.gitprojects.fnbubbles420.org/how-to-download-repos) 📄.\r\n\r\n### Download ZIP:\r\n1. 📥 Click the green `\"Code\"` button at the top right of the repository page.\r\n2. 📂 Choose `\"Download ZIP\"` from the dropdown menu.\r\n3. 📁 This will download a `ZIP file` with the entire repository.\r\n### Extract the ZIP File:\r\n1. 🗂 Find the downloaded `ZIP file` on your computer.\r\n2. 🔧 `Extract` it using your computer's built-in extraction tool or a third-party tool like `WinRAR` or `7-Zip`.\r\n\r\n2. Create a Virtual Environment \u0026 Install Dependencies:\r\n\r\n```bash\r\npython -m venv venv\r\nvenv\\Scripts\\activate\r\npip install -r requirements.txt\r\n```\r\n\r\n3. Install FFmpeg (Required):\r\n- 🥇 Recommended (Chocolatey):\r\n- use powershell\r\n```bash\r\nchoco install ffmpeg -y\r\n```\r\n\r\n- 🧰 Manual Install: Download from: `https://www.gyan.dev/ffmpeg/builds/`\r\nExtract and add the `bin/` folder to your `system PATH`.\r\n\r\n## 🔐 Secure the App\r\nGenerate a Secure Secret Key:\r\n\r\n```bash\r\nimport secrets\r\nprint(secrets.token_hex(32))  # 64-character hex string\r\n```\r\n\r\n## Create a config.json file in the project root:\r\n\r\n```json\r\n{\r\n    \"SECRET_KEY\": \"your-secure-64-character-key\"\r\n}\r\n```\r\n\r\n## 🚀 Run the Application\r\n```bash\r\npython run.py\r\n```\r\n- Then visit 👉 http://localhost:5000\r\n\r\n## 📡 Usage\r\n- Drag and drop your file into the web app.\r\n- Choose a custom output name and compression settings.\r\n- Select advanced GPU settings (NVIDIA/AMD) if applicable.\r\n- Download your converted file instantly.\r\n\r\n## 🔒 Security Notes\r\n\r\n- Debug mode is disabled in production (`debug=False`)\r\n- MIME validation and path sanitation ensure safe conversion\r\n- All temporary and converted files stay local (no cloud storage)\r\n---\r\n# ❤️ From the Dev\r\nThis tool is built with love to help others convert files easily and securely—especially for those needing GPU power on local machines. \r\nHave fun converting and customizing your media!\r\n---\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fbubbles-cloud-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkernferm%2Fbubbles-cloud-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fbubbles-cloud-converter/lists"}