A modern audio file management tool with batch renaming, tag editing, and audio resampling

English | 简体中文

Re:Music is a native desktop audio file management tool built with Flutter. It supports batch renaming based on audio metadata, music tag editing, online metadata retrieval (WIP), and audio resampling with format conversion.

• Batch Renaming: Supports reading audio metadata and provides flexible renaming rule configuration, including {artist} and {albumArtist} placeholders
• Music Tag Editing: Supports separate editing of track artist and album artist, with batch modification and saving capabilities
• Online Metadata Retrieval (WIP): Fetch song tags and cover art from online sources
• Audio Resampling: Audio resampling with format conversion, including lossless profile targets and MP3 output options.
• File Management: Supports drag-and-drop import of folders or files, file list filtering, and sorting
• Personalization: Built-in light and dark modes, hue slider theme tuning (MD3), and support for Chinese and English
• Responsive Layout: Left sidebar that auto-collapses when the window is narrow

All constants used in the application are centrally managed in lib/constants.dart for easy maintenance and consistency

Re:Music supports various common audio file formats:

• MP3 (.mp3)
• FLAC (.flac)
• M4A / AAC (.m4a, .aac)
• OGG / Opus (.ogg, .opus)
• WMA (.wma)
• WavPack (.wv)
• DSD (.dsf, .dff)

The app uses pattern-based file renaming with placeholders:

• {artist}: Track artist (fallback: performers -> album artist -> unknown artist)
• {albumArtist}: Album artist
• {title}: Track title
• {album}: Album name
• {track}: Track number
• {index}: Sequential index

Example: {albumArtist} - {track} - {title} -> Album Artist - 01 - Track Title.mp3

This project is built with Flutter and primarily uses the following technologies and libraries:

• Framework: Flutter (Windows Desktop)
• Language: Dart
• State Management: provider
• Core Dependencies:
  • audio_metadata_reader: Fast cross-format metadata parsing.
  • audiotags: Detailed metadata reading and writing (e.g., track artist and album artist).
  • window_manager: Desktop window management.
  • file_picker: File picker.
  • intl: Internationalization.
  • provider: State management.
  • path: Path handling.

Ensure your development environment has:

• Flutter SDK (3.38.6+)
• Visual Studio C++ Tools

1. Clone the project

   git clone https://github.com/ChuwuYo/Re-Music.git
   cd Re-Music

2. Manage Dependencies

   • Install dependencies: flutter pub get
   • Update dependencies: flutter pub upgrade

3. Run

   flutter run -d windows

dart format .
flutter analyze
flutter test

flutter pub get
flutter pub outdated
flutter gen-l10n

This project provides a PowerShell script that automatically increments the build number and completes the Release compilation:

.\build.ps1 -Version "0.0.1"

flutter build windows --release

The build artifacts are located in the build/windows/runner/Release/ directory Distribute this folder directly as a zip file

To generate an installer like .exe, you need to use third-party tools (such as NSIS / Inno Setup) to package the portable build files Note: This project currently does not integrate an automatic packaging script

MIT LICENSE

Copyright © 2026 ChuwuYo. All rights reserved.