Audio File Thumbnailer

This is a fast and lightweight audio file thumbnailer written in Rust. It generates thumbnails for audio files that can be used by file managers.

Overview

• Fast and Lightweight: Thanks to rust programming language.
• Customizable: You can specify precisely how you want your thumbnail to look, by customizing quality , aspect ratio treatment, interpolation algorithm, waveform color, and waveform size.
• Multipurpose: It can generate album covers for audio files. Without embedded cover art it generates waveforms to represent the audio content visually.
• Modular: You can out-out of features you don't need

Supported formats

mime type	extension	waveform	cover art
audio/aac	.aac	✅	❌
audio/aiff	.aiff .aif .aff	✅	❌
audio/flac	.flac	✅	❌
audio/mpeg	.m2a .m3a .mp2 .mp2a .mp3 .mpga	✅	✅
audio/ogg	.oga .ogg .spx	✅	❌
audio/wav	.wav	✅	❌
audio/x-wavpack	.wv	❌	❌
audio/x-opus+ogg	.opus	✅	❌
audio/midi	.mid .midi	✅	-
audio/x-mpegurl	.m3u	-	❌

Installation

Before using the thumbnailer, ensure that you have Rust installed on your system. You can install Rust from here.

# Clone the repository
git clone https://github.com/eye-wave/audio-thumbnailer

# Navigate to the project directory
cd audio-thumbnailer

# Build the project
make install

Usage

The thumbnailer supports the following command line options:

audio-thumbnailer [OPTIONS] --input <input> --output <output>

Example

audio-thumbnailer -i input.mp3 -o thumbnail.png

Command line arguments

• --input <input>: Specifies the input audio file.
• --output <output>: Specifies the output file name for the generated thumbnail.

Contributing

Contributions are welcome! If you have any suggestions, bug fixes, or improvements, feel free to open an issue or submit a pull request.