HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
sandreas
tone
C#2022–2025
sandreas / tone

tone

tone is a cross platform audio tagger and metadata editor to dump and modify metadata for a wide variety of formats, including mp3, m4b, flac and more. It has no dependencies and can be downloaded as single binary for Windows, macOS, Linux and other common platforms.

4Distinct people
29Mentions
1Explicit recommenders
525GitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

tone is a cross platform audio tagger and metadata editor to dump and modify metadata for a wide variety of formats, including mp3, m4b, flac and more. It has no dependencies and can be downloaded as single binary for Windows, macOS, Linux and other common platforms.

GitHub

Where it is used

No documented product use has been verified yet.

What people are saying

I love ExifTool. Inspired me to create tone[1] - just because I did not find out how to edit/dump audio chapters as I wanted :-) Great piece of software! Keep up the good work.…

sandreas used a recommendation phrase. 2 indexed comments match. This is a phrase match, not a verdict.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 8:59:02 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year29 dated mentions

Observed mentions: 2022-05-22 12:26:44 UTC to 2025-02-11 11:33:40 UTC.

0510152022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 16 mentions; 6 submissions, 10 comments20222023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 7 mentions; 1 submissions, 6 comments20232024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 4 mentions; 1 submissions, 3 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2025

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC16610
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC716
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC413
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC202

What Hacker News says

16 sources
sandreas·Nov 6, 2022Submission

Show HN: Tone 0.1.2 – hackable cross platform audio tagger

Hey HN, I just wanted to show the next version on my little (maybe useless) side project called tone[1] to get some qualified feedback. tone is a cross plattform command line audio tagger deployed as a single static binary without dependencies, so a wget should be enough to install on any platform (seems not to work on M1 Macs atm... if someone can help here I would really appreciate it). It gained some major improvements since the last version. As soon as .NET 7 is out, I plan to integrate AOT (ahead of time compilation)... Features: - dump and modify metadata for supports most common audio formats (mp3, m4a, flac, ape, etc.) - use JSONPath to query single metadata fields in dumps (--query='$.meta.album') - most common AND custom metadata fields (album, artist, but also sort-title, movement-name, etc.) - Chapter support for mp3
Read the rest
and m4a - Embeddable pictures - Custom `tone.json` metadata format to export / import all metadata in one file (including covers as base64) - Hackable via custom JavaScript functions (write your own taggers with url fetching and custom parameters)[2] - dump range of raw audiodata bytes (e.g. to calculate hashes) Thanks and have fun. [1]: https://github.com/sandreas/tone [2]: https://github.com/sandreas/tone#custom-scripted-taggers-experimental
3 points · Open discussion
Hey, I'm the author of m4b-tool[1] and tone[2]. The most important thing I learned about software development, is that the best software has a meaning to yourself and that you should use it yourself on a regular basis. m4b-tool is a tool to merge multiple audio files into the m4b audio book format. I hacked it together in a weekend in the language I knew best (PHP) and that probably was the worst for the job. All because there were no tools, that fitted my needs. After the first improvements I said to my self: Why not open source it, even if it is in a pretty crappy state? And the feedback was surprisingly good for a hackish script. And I learned A LOT from the community (e.g. how to implement something like multithreading in PHP or the simple fact that `cd -` goes back one directory in history). Another important thing I learned is, that
Read the rest
early shipping is good, but automatic deployment and versioning is nearly as important. Thats why I decided to invest some time and simply release `tone` based on git tags with github actions... that was a very good decision so far. So to conclude: Build something, that you use (and want to improve) yourself Ship early Go for auto-deployment / CI as soon as possible Do some "marketing" for high quality feedback (e.g. on hackernews) Cover your ass with automatic tests as soon as possible [1]: https://github.com/sandreas/m4b-tool [2]: https://github.com/sandreas/tone
In Ask HN: HN people who write meaningful software, how did you learn to program?
Sure, why not... so my pet project is basically for managing my audio files. There already is navidrome[1] and audiobookshelf[2]. They work great so far, but some minor details are kind of annoying... The first milestone will be providing a basic API for my files - the main components of this will be the database (postgres), the API (C# + swashbuckle + JsonApiDotNet + Websockets) and the file indexer (C# HostedService). All parts except the file indexer are pretty much done, but it is a critical component, because it has to be as fast and correct as possible. There are multiple approaches to index files... A best case scenario would be an "import" / "move" of files into a library or repository. That way you would be always up to date and always perfectly sorted. Unfortunately, an import would also be a big amount of work, because analysin
Read the rest
g the files and getting metadata from online sources is... lets say a huge project. And NOT getting metadata would mean, that I cannot move the files while another app manages the metadata. So I took another path - scanning an existing and well tagged library (that I manage with beets[3] for music and m4b-tool[4] / tone[5] for audio books). My current Idea is to have a file indexer that: - can run on multiple sources - runs one full index scan after starting the app - registers a filesystem watcher for every file source and reacts to events - To ensure, no filesource is blocking others, each source is processed by a fixed batch size and then move on the the next file source - If sources are modified (added, changed, deleted), there is a decision, what to do with already running indexers and registered file watchers (added just go to the queue, changed and deleted cancel already running tasks only for this source) - All files are hashed (content only) to ensure, a change of metadata or tags will not change the hash, and if a file is moved, it will recognize this and update instead of delete and insert The database will contain Tag-Values for every possible value. E.g. File.Location music/album/AC_DC/Back in Black/01 - Hells Bells.mp3 FileTag.Type Artist Tag.Value AC/DC That way I can add a fulltext index on the Tags.Value field containing a searchable value while maintaining the FileTag.Type for recommendations. Let's say I search for `AC/DC`, it will provide an auto-complete for all FileTags.Type values, that show a match + a generic one for searching ALL values: Artist: AC/DC FullText: AC/DC Searching for 2010 will show: Released: 2010 Title: 2010 FullText: 2010 because it contains matches in Releasedate and title. There may be a lot to optimize, but I think my current plan goes pretty well. Let me know what you think about this approach :-) [1]: https://www.navidrome.org/ [2]: https://www.audiobookshelf.org/ [3]: https://beets.io/ [4]: https://github.com/sandreas/m4b-tool/ [5]: https://github.com/sandreas/tone/
In Ask HN: What interesting problems are you working on?
sandreas·Aug 9, 2022Submission

Show HN: Tone v0.0.8 – hackable console audio tagger – feedback for new version?

Hey HN, I would like to show you my new version of tone [1], a command line audio tagger. It is mainly developed for audiobooks, but should also work for music and other formats. Features: - dump metadata in different formats with JSONPath support tone dump my-file.m4b tone dump --format=json --query='$.meta.album' my-file.m4b - modify most common audio formats metadata tone tag input.mp3 --meta-title "a title" tone tag --auto-import=covers --auto-import=chapters --path-pattern="audiobooks/%g/%a/%s/%p - %n.m4b" --path-pattern="audiobooks/%g/%a/%z/%n.m4b" audiobooks/ --dry-run - write your own custom scripted tagger extensions with JavaScript tone tag "harry-potter-1.m4b" --taggers="musicbrainz" --script="musicbrainz.js" --script-tagger-parameter="e2310769-2e68-462f-b54f-25ac8e3f1a21" - multiarch docker image is also availabl
Read the rest
e via docker pull sandreas/tone:v0.0.8 Feedback is highly appreciated. [1]: https://github.com/sandreas/tone
2 points · Open discussion
sandreas·Jul 16, 2022Submission

Show HN: Tone v0.0.7 – scriptable command line audio tagger with docker support

Hey HN, again some progress on my little (maybe useless) toy project called tone[1] hoping for feedback. tone is a cross plattform command line audio tagger deployed as a single static binary without dependencies, so a wget should be enough to install on any platform (seems not to work on M1 Macs atm... if someone can help here I would really appreciate it). Improvements since the last post (v0.0.4): - multiarch docker image for all major platforms - docker pull sandreas/tone:v0.0.7 - docker run -it --rm -u $(id -u):$(id -g) -v "$(pwd)":/mnt sandreas/tone:v0.0.7 dump my-audio-book.m4b - new JSON metadata format with JSONPath support - tone dump my-file.m4b --format=json --query="$.meta.album" - metadata writer fixes for m4b audiobooks iTunes General Features: - Supports most common formats (mp3, m4a, flac, ape, etc
Read the rest
.) - Most common AND custom metadata fields - Chapter support - Embeddable pictures - Hackable (write your own taggers with scripting language) Thanks and have fun. [1]: https://github.com/sandreas/tone
2 points · Open discussion
Usually, for electronic devices I start with the Open Source Projects recommendations or first class support items... They usually have good hardware quality e.g. for a smartphone, I look at lineage devices first and then check out reviews for these, that work for me from looking at the specs. For your purpose, there is no such audio player, I know of. The best devices I know atm are: - iPod Nano 7th gen 16GB - Pro: Size, Bluetooth, UI - Con: Battery, Storage, Formats, req. iTunes, no Wifi / NFC, No Upgrades - iPod classic (mod with iFlash Quad and 2200mah battery + iKokkia Bluetooth) - Pro: Storage, Battery, UI, Hackable (kind of) - Con: Size, Formats, req. Itunes, No native Bluetooth/Wifi/NFC, No upgrades - Maybe you should think of RockBox to have more freedom - LG G5 H850 (optional with Bang & Olufsen Hifi-Pl
Read the rest
us module) + Audiobookshelf + Substreamer - Pro: Formats, Battery, Storage, Bluetooth/Wifi/NFC, Hackable - Con: Size, UI (I did not find a Server/App nearly as good as iPod) Let me cite my comment from https://news.ycombinator.com/item?id=32042780: I use m4b-tool[1], tone[2] and audiobookshelf[3] together with an LG G5 H850 smartphone[8] with Bang & Olufsen Hifi-Plus Module for Audio Only and I am pretty happy with this config. For Music I use Navidrome[5] and Substreamer App[7]. Maybe I'll try out Jellyfin[4] or maybe Plex[6], but I really don't wanna go closed source. I also thought about writing something self hosted in C# to have ONE solution for audiobooks, podcasts and music and started a small private project, but this will take a while until it is ready to release something... You may ask: Why an LG G5 H850? Well, its relatively small and cheap (about 50 - 80 bucks used) it has an audio Jack, USB-C, you can change the battery, it can hold up to 2TB microSD storage, has an HiFi Plus module for audio enthusiasts and a descent screen. Besides that it can run lineage os... Note: I'm the author of the first two projects :-) [1]: https://github.com/sandreas/m4b-tool [2]: https://github.com/sandreas/tone [3]: https://github.com/advplyr/audiobookshelf [4]: https://jellyfin.org/ [5]: https://www.navidrome.org/ [6]: https://www.plex.tv [7]: https://substreamerapp.com/ [8]: https://en.wikipedia.org/wiki/LG_G5
In Ask HN: How do you search for products / apps given a list of requirements?
I use m4b-tool[1], tone[2] and audiobookshelf[3] together with an LG G5 H850 smartphone[8] with Bang & Olufsen Hifi-Plus Module for Audio Only and I am pretty happy with this config. For Music I use Navidrome[5] and Substreamer App[7]. Maybe I'll try out Jellyfin[4] or maybe Plex[6], but I really don't wanna go closed source. I also thought about writing something self hosted in C# to have ONE solution for audiobooks, podcasts and music and started a small private project, but this will take a while until it is ready to release something... You may ask: Why an LG G5 H850? Well, its relatively small and cheap (about 50 - 80 bucks used) it has an audio Jack, USB-C, you can change the battery, it can hold up to 2TB microSD storage, has an HiFi Plus module for audio enthusiasts and a descent screen. Besides that it can run lineage os... Note:
Read the rest
In Ask HN: Is there a Calibre equivalent for Audio books?
sandreas·Jun 26, 2022Recommendation phrase
> Very neat, I love it, I used to have a tool to do this but it's been ages and is now unmaintained. Thank you :-) Glad to hear that. > Just be sure to do input santization, since if someone else uses your code it could go from a very cool project to a backdoor that ends up on the front page for all the wrong reasons :-) Good point. I think that the "scriptable" part needs special care regarding security issues, as well as the metadata-readers and JSON parsers. I don't want that to bite me in the neck because of a "malicious" file. Maybe it is worth to provide a responsible disclosure email and make a plan for security issues. See https://github.com/sandreas/tone/issues/12
In Show HN: Tone v0.0.4 – now hackable command line audio tagger, any feedback?
sandreas·Jun 25, 2022Submission

Show HN: Tone v0.0.4 – now hackable command line audio tagger, any feedback?

Hey HN, I just wanted to show the progress on my little (maybe useless) side project called tone[1] to get some qualified feedback. tone is a cross plattform command line audio tagger deployed as a single static binary without dependencies, so a wget should be enough to install on any platform (seems not to work on M1 Macs atm... if someone can help here I would really appreciate it). Features: - Supports most common formats (mp3, m4a, flac, ape, etc.) - Most common AND custom metadata fields - Chapter support - Embeddable pictures - Hackable (write your own taggers with scripting language) Thanks and have fun. [1]: https://github.com/sandreas/tone
23 points · Open discussion
My audio workflow is basically command line / self-hosted: - beets [1] for music tagging - m4b-tool [2] and tone [3] for audio books merging and tagging (Note: I'm the author of these) - iTunes and an iPod Nano 7g and iPod classic 2009 to listen "offline" (although audiobookshelf supports offline downloads) - self-hosted navidrome [4] + substreamer[5] for music and audiobookshelf [6] for audio books on my android / ios devices Everything with docker containers without further dependencies. I must say, that this works pretty good so far and I never missed something really bad on id3v2.3 or mp4/m4b native tags. [1]: https://beets.io/ [2]: https://github.com/sandreas/m4b-tool/ [3]: https://github.com/sandreas/tone [4]: https://github.com/navidrome/navidrome [5]: https://substreamerapp.com/ [6]: https://www.audiobookshelf.org/
In What ID3v2 could have been
sandreas·Jun 2, 2022Submission

Show HN: Tone – a pure C# cross platform auto tagger without dependencies

Hey HN, just wanted to show my latest project called tone to get your feedback. It is a cross platform command line audio tagger. Currently in an early state of development it already comes with a neat set of features: - read and write support for a decent amount of fields - supports id3, mp4, flac and most other formats - chapters, covers and even custom tag fields - install one single binary - no dependencies (M1 macOS does not work atm - maybe someone can help out here) Source code and release download: <https://github.com/sandreas/tone> Feedback is really appreciated. Thanks :-)
2 points · Open discussion

Showing the 15 most recent of 16 sources. Enable JavaScript to search and browse every indexed mention.

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.