Som-Music-Converter Svelte Themes

Som Music Converter

Ultimate local media converter - Download YouTube videos/audio and convert images. Zero ads, zero tracking, total privacy. Built with Svelte + Node.js + FFmpeg

#desktop-app#express#tailwindcss#youtube-downloader#yt-dlp
Download
SOM Music Media Tool Logo

🎵 SOM Music Media Tool

💎 The Ultimate Local Media Converter

Download YouTube videos, extract high-quality audio, and convert internet images—all running securely on your own machine.

🚫 Zero ads · 🔒 Zero tracking · 🛡️ Total privacy

📺 Visual Demo

See the application in action:

How to Use

The GIF above demonstrates how to paste a link, select a format, and download files directly to your system.

🌟 Key Features

🎧 YouTube Downloader

  • Audio Mode (MP3): Extracts the highest quality audio track and converts it to MP3.
  • Video Mode (MP4): Merges the best available video stream with the best audio stream for crisp MP4 playback.
  • Smart Thumbnails: Automatically previews the video cover before you download.
  • Cover Art Saver: Option to save the YouTube thumbnail as a JPG.

🖼️ Universal Image Tool

  • Any Link: Paste a direct link to any image on the web.
  • Format Conversion: Automatically convert downloaded images to your preferred format:
    • JPG (Standard)
    • PNG (Transparent/High Quality)
    • SVG (Vector/Scalable)

🔒 Privacy & Local Control

  • Local Bridge: Uses a custom Node.js backend to bypass browser security limits.
  • Direct Saving: Files are saved directly to your Desktop, Documents, or Downloads folder—no need to dig through temporary files.
  • Cross-Device: Host the app on your PC and control it from your smartphone via Wi-Fi.

🛠️ Tech Stack & Architecture

This project uses a "Local Bridge" architecture to combine the power of desktop tools with the ease of a web interface.

Component Technology Description
Frontend Svelte + Vite The reactive user interface (UI). Fast and lightweight.
Styling Tailwind CSS Modern, responsive design system.
Backend Node.js + Express The local server that handles system commands.
Engine yt-dlp A powerful command-line media downloader.
Converter FFmpeg The industry-standard tool for processing audio and video files.

🚀 Installation Guide

Prerequisites

Before you begin, ensure you have the following installed:

Clone the Repository

📋 Open your terminal and run:

git clone https://github.com/YOUR_USERNAME/Som-Music-Converter.git
cd Som-Music-Converter.git

Install Dependencies

📦 Download the necessary JavaScript libraries:

npm install

Setup FFmpeg (Crucial Step!)

⚠️ IMPORTANT: This app requires FFmpeg to handle media conversion.

📥 Step 4.1: Download FFmpeg Essentials (Windows) from gyan.dev.

📂 Step 4.2: Open the ZIP file and navigate to the bin folder.

📁 Step 4.3: Create a new folder named tools inside your project's root directory.

📋 Step 4.4: Copy ffmpeg.exe and ffprobe.exe into that tools folder.

Your folder structure should look like this:

Som-Music-Converter.git/
├── node_modules/
├── src/
├── tools/                <-- Create this folder
│   ├── ffmpeg.exe        <-- Place file here
│   └── ffprobe.exe       <-- Place file here
├── server.js
├── package.json
└── README.md

⚡ How to Run

🖱️ Method 1: The One-Click Launcher (Windows)

🚀 Easiest Way! We have included a batch script for easy startup.

1️⃣ Locate start.bat in the project folder.

2️⃣ Double-click it.

3️⃣ It will open the backend, frontend, and launch your default browser automatically.

⌨️ Method 2: Manual Terminal Startup

💻 If you prefer using the command line, open two separate terminals.

Terminal 1 (The Backend Worker):

node server.js

You should see: Backend Worker running on http://localhost:3001

Terminal 2 (The Web Interface):

npm run dev

You should see: Local: http://localhost:5173/

📖 Usage Manual

🎧 Mode 1: YouTube Downloader

1️⃣ Click the "YouTube" tab in the app.

2️⃣ Paste a YouTube link (e.g., https://www.youtube.com/watch?v=...).

3️⃣ Wait for the thumbnail preview to appear.

4️⃣ Select your format:

  • 🎵 MP3: For music/audio only.
  • 🎬 MP4: For full video.

5️⃣ Select your Save Location (e.g., "System Downloads").

6️⃣ Click Download. The progress bar will show the status.

🖼️ Mode 2: Image Tool

1️⃣ Click the "Image Tool" tab.

2️⃣ Paste a direct link to an image (e.g., a Google Image result ending in .jpg or .png).

3️⃣ Select the output format you want (JPG, PNG, or SVG).

4️⃣ Click Download Image. The app will download and convert it automatically.

📱 Mobile / Local Network Usage

📲 You can use this tool on your phone to trigger downloads on your computer!

1️⃣ Ensure your PC and Phone are connected to the same Wi-Fi network.

2️⃣ Run the app on your PC.

3️⃣ Check the Frontend terminal (where you ran npm run dev). It will show a Network IP:

> Network:  http://192.168.1.15:5173/

4️⃣ Type that specific address (IP:Port) into your phone's browser (Chrome/Safari).

5️⃣ The app will load on your phone. Any download you start will save files to your PC's hard drive.

❓ Troubleshooting

🐛 Q: The download stays at 0% forever.

A: Check your internet connection. Also, verify that tools/ffmpeg.exe exists. If the backend cannot find FFmpeg, it cannot start the conversion.

🔴 Q: I get a "Network Error" red box.

A: Ensure the Backend is running. The frontend needs node server.js running in the background to work.

🖼️ Q: The Image Tool says "Image not found".

A: Ensure the link is a direct image link (usually ends in .jpg, .png, .webp). Some websites block direct downloading (hotlinking).

🔒 Security & Support

🚨 Found a Security Issue?

If you discover a security vulnerability, please report it responsibly:

🌐 Contact Form:
som-music-admin.vercel.app/contact

💬 Discord Server:
discord.gg/hjhm4RtgP2

📧 Email:
security@somali-music.org

🐙 GitHub Security:
Report a Vulnerability

📖 Full Security Policy:
See SECURITY.md for detailed information.

⚖️ License & Disclaimer

📜 License: MIT License. Free to use and modify.

⚠️ Disclaimer:
This tool is intended for Personal and Educational Use Only. The developers do not endorse copyright infringement. Users are responsible for complying with YouTube's Terms of Service and applicable copyright laws in their country.

Made with 💻 by Yusuf

⭐ Star this repo if you find it useful! ⭐

Top categories

tailwinddaisyuiadmin templatepopupmdsvexportfolioblogformecommerceuicarouselauthdarkseoimagerouting
Loading Svelte Themes