Re:Music

A modern music tag manager and batch renaming tool

简体中文 | English

---

Introduction

Re:Music is a native desktop audio file management tool built with Flutter. It supports batch renaming based on audio metadata and editing music tags (WIP).

Preview

Key Features

• Batch Renaming: Supports reading audio metadata and provides flexible renaming rule configuration.
• Music Tag Editing (WIP): Edit audio metadata, with batch modification and saving capabilities.
• File Management: Supports drag-and-drop import of folders or files, file list filtering, and sorting.
• Personalization: Built-in light and dark modes, multiple MD3 color modes, and support for Chinese and English.

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)

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: Audio metadata reading.
  • audiotags: Audio metadata writing.
  • 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.10.0+)
• Visual Studio C++ Tools

Running and Development

1. Clone the project

   git clone https://github.com/ChuwuYo/ReMusic.git
   cd ReMusic

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. You can distribute this folder directly as a zip.

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.