Unmuze - GitLite

KO | EN

gitlite — search

#rust #generative-ai #self-hosted #privacy #proxy #video #command-line #gpt #svg #mysql

Unmuze

(★ 32)

Local desktop app for saving permitted YouTube and SoundCloud media.

File Explorer

ZIP Download

- - v0.4.0.md
  - v0.5.0.md
  - v0.5.1.md
  - v0.5.2.md
  - v0.5.3.md
- - ci.yml
  - platform-smoke.yml
  - release.yml
- - unmuze-icon.png
- favicon.png
- check-release-tag.mjs
- check-updater-artifacts.mjs
- check-version-alignment.mjs
- - unmuze-icon.png
- - media.test.ts
  - media.ts
  - tauri.ts
  - utils.ts
- App.test.tsx
- App.tsx
- index.css
- main.tsx
- - default.json
- - 128x128.png
  - [email protected]
  - 32x32.png
  - icon.icns
  - icon.ico
  - icon.png
  - Square107x107Logo.png
  - Square142x142Logo.png
  - Square150x150Logo.png
  - Square284x284Logo.png
  - Square30x30Logo.png
  - Square310x310Logo.png
  - Square44x44Logo.png
  - Square71x71Logo.png
  - Square89x89Logo.png
  - StoreLogo.png
- - lib.rs
  - main.rs
- .gitignore
- build.rs
- Cargo.lock
- Cargo.toml
- tauri.conf.json
.gitignore
BUILD.md
components.json
CONTRIBUTING.md
eslint.config.js
index.html
INSTALL.md
LICENSE
package-lock.json
package.json
README.md
SECURITY.md
tsconfig.app.json
tsconfig.json
tsconfig.node.json
vite.config.ts
vitest.config.ts
vitest.setup.ts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`yt-dlp`

View Details ▼

A youtube-dl fork with additional features and fixes.
Download videos from YouTube and other websites.
See also: `ytfzf`.

yt-dlp "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"

Download a video or playlist (with the default options from command below):

yt-dlp {{[-F|--list-formats]}} "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"

List the available downloadable formats for a video:

yt-dlp {{[-f|--format]}} "{{bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]}}" "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"

Download a video or playlist using the best MP4 video available (default is "bv\*+ba/b"):

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="docs/assets/unmuze-icon.png" alt="Unmuze app icon" width="220" />
</p>

Unmuze is a lightweight local desktop app for Windows, macOS, and Linux that lets a user paste a supported media URL, inspect it, and save permitted audio or video content locally.

The app is local-first. It does not require an account, does not use a cloud backend, and stores only local preferences and Library records on the user device.

## What It Does

- Accepts public YouTube, SoundCloud, TikTok, Instagram, Twitter/X, and Pinterest media URLs, including YouTube playlists and SoundCloud sets in Playlist mode.
- Detects the platform automatically.
- Shows available metadata when local tooling can inspect the URL.
- Installs checksum-verified managed copies of `yt-dlp` and FFmpeg into the local app data folder.
- Saves audio or video through managed or system media tooling when the content is legally permitted and technically available.
- Runs playlist downloads concurrently with a configurable limit of 1, 2, or 3 items at a time.
- Provides simple **Best** and **Balanced** presets plus explicit MP3, M4A, Opus, WAV, MP4 best, MP4 1080p, and MP4 720p choices.
- Includes an advanced source format picker that can show available resolution, container, codecs, bitrate, fps, and size details after inspection.
- Embeds title, uploader/artist metadata, source URL, and thumbnail artwork when the selected output format supports it.
- Can split chaptered videos, podcasts, lectures, or albums into separate files by chapter.
- Can save manual subtitles or auto-generated captions as SRT sidecar files for video downloads.
- Shows progress, cancellation, completed downloads, and a searchable local Library with thumbnails, source metadata, format details, path status, and playlist grouping.
- Supports platform-specific default format and preset choices for YouTube, SoundCloud, TikTok, Instagram, Twitter/X, and Pinterest.
- Can place playlist downloads in a sanitized playlist-named folder.
- Provides completed-download actions to open saved files or reveal their containing folder.
- Supports light, dark, and system theme settings.
- Checks for Tauri signature-verified app updates from inside Settings.

## What It Does Not Do

- Does not bypass DRM, paywalls, login restrictions, private links, encryption, region locks, or other access controls.
- Does not download profiles, timelines, boards, collections, hashtags, stories, searches, likes, lists, DMs, or bulk social media sources.
- Does not download Spotify tracks, albums, or playlists. Spotify does not expose downloadable audio files for this kind of app without protected access.
- Does not create accounts, collect analytics, or upload media URLs to an Unmuze service.

## Supported URL Types

| Platform | Inspect | Download |
| --- | --- | --- |
| YouTube public URLs | Yes, when local tools can access metadata | Yes, only when legally permitted |
| YouTube public playlists | Yes, with per-item selection | Yes, selected public items only when legally permitted |
| SoundCloud public URLs | Yes, when local tools can access metadata | Yes, only when legally permitted |
| SoundCloud public sets | Yes, with per-item selection | Yes, selected public audio items only when legally permitted |
| TikTok public video URLs | Yes, when local tools can access metadata | Yes, individual public videos only when legally permitted |
| TikTok profiles/playlists | Unsupported message | No |
| Instagram public post, reel, reels, and TV URLs | Yes, when local tools can access metadata | Yes, individual public video/media items only when legally permitted |
| Instagram profiles, stories, hashtags, searches, collections | Unsupported message | No |
| Twitter/X public status URLs | Yes, when local tools can access metadata | Yes, individual public posts only when legally permitted |
| Twitter/X profiles, timelines, searches, lists, communities | Unsupported message | No |
| Pinterest public Pin URLs under `pinterest.com/pin/{id}` and `pin.it` short links that resolve to pins | Yes, when local tools can access metadata | Yes, individual public video pins only when legally permitted |
| Pinterest boards, profiles, searches, and short links that do not resolve to pins | Unsupported message | No |
| Spotify | Protected-platform explanation only | No |
| Other sites | Unsupported message | No |

## Legal-Use Notice

You are responsible for having the rights to download any content you save. Use Unmuze only when the source, your rights, and the platform terms permit downloading.

## Basic Usage

1. Install Unmuze for your operating system.
2. Open Unmuze.
3. In Settings, choose **Install managed tools** if the app reports missing media tools.
4. Use **Check for updates** in Settings when you want to install the latest verified release without visiting GitHub.
5. Paste a supported public URL in Download mode, or open Playlist mode for a YouTube playlist or SoundCloud set.
6. Select audio or video, choose a preset or an advanced source format, choose an output folder, and save locally.
7. Open advanced options when you want chapter splitting or subtitles for sources that provide them.

See [INSTALL.md](INSTALL.md) and [BUILD.md](BUILD.md) for setup and packaging instructions.