https://github.com/eye-wave/audio-thumbnailer
Fast multipurpose thumbnailer for creating audio thumbnails on linux.
https://github.com/eye-wave/audio-thumbnailer
audio linux thumbnail-generator thumbnailer waveform-generator
Last synced: 18 days ago
JSON representation
Fast multipurpose thumbnailer for creating audio thumbnails on linux.
- Host: GitHub
- URL: https://github.com/eye-wave/audio-thumbnailer
- Owner: eye-wave
- Created: 2024-04-10T18:30:45.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-17T19:05:28.000Z (over 1 year ago)
- Last Synced: 2025-02-17T19:40:40.265Z (over 1 year ago)
- Topics: audio, linux, thumbnail-generator, thumbnailer, waveform-generator
- Language: Rust
- Homepage:
- Size: 661 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://www.rust-lang.org/tools/install).
```bash
# 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:
```bash
audio-thumbnailer [OPTIONS] --input --output
```
#### Example
```bash
audio-thumbnailer -i input.mp3 -o thumbnail.png
```
#### Command line arguments
- `--input `: Specifies the input audio file.
- `--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.
test