Re:Music

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

English | 简体中文

---

Introduction

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 (WIP).

Preview

Key Features

• 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 (WIP): Lossless audio downsampling for improved compatibility.
• 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

Constants Management

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

Supported Formats

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)

Naming Patterns

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

Tech Stack

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.

Getting Started

Prerequisites

Ensure your development environment has:

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

Running and Development

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

Build and Release

1. Automated Build (Recommended)

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

.\build.ps1 -Version "0.0.1"

2. Manual Portable Build

flutter build windows --release

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

3. Installer

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

License

MIT LICENSE

Copyright © 2026 ChuwuYo. All rights reserved.