Snowify

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 279 Open GitHub ↗

A desktop music player built with Electron that streams audio from YouTube Music. Clean UI, no accounts, no ads.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A desktop music player built with Electron that streams audio from YouTube Music. Clean UI, no accounts, no ads.

> [!WARNING]
> The app is still constantly being worked on and may contain a few bugs or experimental features, use at your own discretion.

> [!IMPORTANT]
> **Cloud Sync will stop working on any version prior to 2.0.** Please update to v2.0 or later to continue using Cloud Sync.

## Features

- **Search** — Find songs, artists, and albums via YouTube Music
- **Playback** — Stream audio directly with play/pause, seek, skip, volume
- **Queue** — View and manage upcoming tracks, drag reorder
- **Smart Queue** — Auto-fills with similar songs when the queue runs out
- **Shuffle & Repeat** — Shuffle queue, repeat one or all
- **Playlists** — Create, rename, delete, and add/remove tracks. Custom or auto-generated covers. Drag & drop songs into sidebar playlists
- **Liked Songs** — Heart any track to save it
- **Synced Lyrics** — Spotify-like synced lyrics from multi-source
- **Artist Pages** — Top songs, discography, monthly audience, fans also like, and live performances
- **Follow Artists** — Follow artists and see their recent releases on the home page
- **Music Videos** — Watch music videos in-app
- **Discord Rich Presence** — Show what you're listening to on Discord
- **Cloud Sync** — Sign in with email to sync your library across devices
- **Themes** — Built-in color themes
- **Keyboard Shortcuts** — Full keyboard control (see below)

## Screenshots

| | |
|---|---|
| ![Home](https://raw.githubusercontent.com/nyakuoff/Snowify/main/assets/screenshots/home.png) | ![Artist](https://raw.githubusercontent.com/nyakuoff/Snowify/main/assets/screenshots/artist.png) |
| ![Lyrics](https://raw.githubusercontent.com/nyakuoff/Snowify/main/assets/screenshots/lyrics.png) | ![Playlist](https://raw.githubusercontent.com/nyakuoff/Snowify/main/assets/screenshots/playlist.png) |
| ![Explore](https://raw.githubusercontent.com/nyakuoff/Snowify/main/assets/screenshots/explore.png) | ![Discord RPC](https://raw.githubusercontent.com/nyakuoff/Snowify/main/assets/screenshots/discord-rpc.png) |

## Getting Started

You'll need [Node.js](https://nodejs.org/) (v18+) and [yt-dlp](https://github.com/yt-dlp/yt-dlp) installed on your system.

```bash
# Clone the repo
git clone https://github.com/nyakuoff/Snowify.git
cd snowify

# Install dependencies
npm install

# Run
npm start
```

### Requirements

| Dependency | Purpose |
|---|---|
| [Electron](https://www.electronjs.org/) | Desktop app shell |
| [ytmusic-api](https://github.com/sigmundgranaas/ytmusic-api) | YouTube Music search, artist & album data |
| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | Extracts audio stream URLs (must be in PATH) |
| [synclyrics](https://github.com/Stef-00012/SyncLyrics) | Synced lyrics from Musixmatch, LrcLib, Netease |
| [Firebase](https://firebase.google.com/) | Authentication & cloud sync |

## Keyboard Shortcuts

| Key | Action |
|---|---|
| `Space` | Play / Pause |
| `←` / `→` | Seek backward / forward 5s |
| `Ctrl+←` / `Ctrl+→` | Previous / Next track |
| `↑` / `↓` | Volume up / down |
| `/` | Focus search |

## Tech Stack

- **Electron** — Desktop framework
- **ytmusic-api** — YouTube Music metadata
- **yt-dlp** — Audio stream extraction
- **synclyrics** — Synced lyrics (Musixmatch, LrcLib, Netease)
- **Firebase** — Auth & Firestore cloud sync
- **Discord RPC** — Rich presence integration

## Roadmap

- [x] Outdated

## Legal

This app is for **personal and educational use only**. It streams content from publicly available sources. I am not responsible for how anyone chooses to use it.

## Supporting Snowify

Snowify is growing super fast, and so are the costs to keep it running. If you love using Snowify and want to help it keep thriving, please consider supporting the project:

- **[💝 Donate](https://snowify.cc/donate)** — All donations will be used to maintain Snowify
- **[⭐ Star this repo](https://github.com/nyakuoff/Snowify)** — It really helps!

Every contribution keeps Snowify ad-free and fully open source. Thank you for being part of the community!

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on reporting bugs, suggesting features, submitting pull requests, and translating.

> [!NOTE]
> **AI Disclaimer**: Parts of this project were assisted or written by AI. If that's something you're not comfortable with, no hard feelings, I understand and I don't force anyone to use it. The code may have flaws. If you spot something that could be better, contributions are very welcome. I'm still learning and would appreciate the help.

Snowify

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README