Skip to content

ad-si/Taguar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Taguar Taguar icon

A small desktop app for browsing a directory of audio files and editing their ID3v2 / primary metadata tags. Built with Iced and lofty.

Taguar

Features

  • Select a directory via file dialog or pass one on the command line
  • Recursive scan for audio files (mp3, flac, m4a, m4b, mp4, ogg, opus, oga, wav, aiff, aif, aifc, wv, ape)
  • Left-pane table: Filename (relative path), Artist, Title, Comment; proportional columns that adapt to window size
  • Right-pane sidebar: compact form for Title, Artist, Album, Album Artist, Year, Track, Genre, Composer, Comment, Disc Number, Compilation flag
  • Embedded cover art preview with dimensions, size, MIME and picture type
  • Read-only ID3v1 section shown when a file has an ID3v1 tag (ID3v1 is never written back)
  • Save writes through lofty's TagExt::save_to_path — for MP3/WAV/AIFF this is ID3v2, for FLAC / OGG / M4A it's the format's native primary tag
  • Built-in audio playback via rodio with a Play / Pause button above the Title field
  • Bottom status bar showing selected-file and total duration + size

Installation

From crates.io

cargo install taguar

From source

git clone https://github.com/ad-si/Taguar.git
cd Taguar
cargo install --path .

Running

taguar                        # opens with a dir picker
taguar /path/to/music         # opens that directory
taguar --help                 # print usage

Format support

Playback goes through rodio with symphonia-all, which covers MP3, FLAC, Vorbis, WAV/PCM/ADPCM, and AAC inside MP4/M4A containers. Symphonia 0.5 has no working Opus decoder yet, so .opus files are routed through a dedicated decoder built on libopus (bundled via the opus crate) plus the ogg crate for container parsing.

License

Licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). See LICENSE for the full text.

https://sporks.space/2023/02/18/poor-schemas-poor-cataloguing-why-music-tagging-sucks/