Skip to content

nano-codes/sunosync

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

44 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SunoSync V2

Your World, Your Music. Seamlessly Synced.

SunoSync V2 is the ultimate desktop manager for your Suno AI music generation. It combines a powerful bulk downloader, a feature-rich music library, and a built-in audio player into one seamless application.

SunoSync Splash

Buy the exe or compile yourself below for free:

Discord Support and Community: https://discord.gg/kZSc8sKUZR

🌟 Key Features

πŸ“₯ Smart Downloader

  • Bulk Downloading: Download all your Suno songs in one click.
  • Smart Sync: Only downloads new songs, skipping what you already have.
  • Format Choice: Choose between MP3 (smaller size) or WAV (lossless quality).
  • Organization: Automatically organizes downloads into folders by Year-Month (e.g., 2025-11).
  • Metadata Embedding: Automatically embeds Title, Artist, and Lyrics directly into the audio file tags (MP3 and WAV).
  • Lyrics Files: Option to save lyrics as separate .txt files.
  • Smart Resume: Intelligently stops scanning after consecutive pages with no new songs.
  • Workspace & Playlist Support: Browse and download from your Suno workspaces and playlists.
  • Advanced Filtering: Filter by liked, trashed, stems, public/private, and more.
  • Preload Mode: Preview songs before downloading and uncheck unwanted tracks.

πŸ“š Music Library

  • Visual Browser: Browse your entire collection in a clean, sortable list.
  • Search: Instantly filter songs by Title or Artist.
  • Sorting: Sort by Date, Duration, Size, Title, or Artist.
  • Tag System: Organize songs with Like πŸ‘, Star ⭐, and Trash πŸ—‘οΈ tags with filtering support.
  • Context Menu: Right-click to Play, View/Edit Lyrics, Open Folder, or Delete songs.
  • Auto-Refresh: Library automatically updates when new downloads finish.

🎡 Built-in Player

  • Seamless Playback: Play songs directly within the app without opening external players.
  • Controls: Play/Pause, Stop, Seek Bar, and Volume Control.
  • Playback Modes: Shuffle, Repeat All, and Repeat One modes.
  • Tag Controls: Quick-access Like, Star, and Trash buttons with automatic library synchronization.

✍️ Lyrics Editor

  • View & Edit: Right-click any song to view the embedded lyrics.
  • Multiple Sources: Reads lyrics from both embedded metadata and .txt files.
  • Edit Mode: Fix typos or add your own verses directly in the app.
  • Dual Save: Saves lyrics to both .txt file and audio file metadata.
  • Verification: Automatically verifies that your changes are saved to the file on disk.

🎨 Modern UI & Polish

  • Dark Mode: Sleek, modern dark interface that's easy on the eyes.
  • Customizable Notifications: Option to disable Windows alert notification sounds.
  • Window State: Remembers your window size and position between sessions.
  • Debug Tools: Built-in debug log viewer for troubleshooting.

πŸš€ Getting Started

  1. Download: Get the latest SunoSyncV2.exe or compile from source (see below).
  2. Install VLC: Ensure you have VLC Media Player installed (required for audio playback).
  3. Run: Double-click SunoSyncV2.exe.
  4. Get Token:
    • Click "Get Token" in the Downloader tab.
    • Log in to Suno.com.
    • Open Developer Tools (F12) -> Application -> Cookies.
    • Copy the value of the __client cookie.
  5. Download: Paste your token and click Start Download or Preload to preview first.

πŸ”’ Security & VirusTotal Transparency

We believe in 100% transparency. Because SunoSync is an indie tool built with Python (and not a digitally signed corporation app), a few generic antivirus filters may flag it as "unknown."

The Reality: βœ… 69/72 Security Vendors found NO issues (Clean) ⚠️ 3/72 flagged as "False Positive" (Generic/Heuristic)

These flags occur because the app is "unsigned" (common for indie devs). You can verify the file yourself below:

➒ Click here to view the live VirusTotal Report

β˜• Support

Created by @InternetThot

If you love SunoSync, consider buying me a coffee to support future updates! πŸ‘‰ buymeacoffee.com/audioalchemy


SunoSync is an unofficial tool and is not affiliated with Suno AI.

πŸ› οΈ Building from Source

Prerequisites

  • Python 3.10+
  • Git
  • VLC Media Player (Required for audio playback)

Installation

  1. Clone the repository:

    git clone https://github.com/sunsetsacoustic/SunoSync.git
    cd SunoSync
  2. Install dependencies:

    pip install -r requirements.txt
  3. Run the application:

    python main.py

Compiling to Executable

To build the standalone .exe file:

  1. Install PyInstaller:

    pip install pyinstaller
  2. Build using the spec file:

    pyinstaller SunoApi.spec
  3. The executable will be in the dist/ folder.

About

A modern desktop client to batch download and sync your Suno AI library. Automatically embeds lyrics, cover art, and full metadata into every track. πŸŽ΅πŸ’Ύ

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%