Skip to content(if available)orjump to list(if available)

Show HN: Petrichor – a free, open-source, offline music player for macOS

Show HN: Petrichor – a free, open-source, offline music player for macOS

66 comments

·July 9, 2025

I have a large collection of music files gathered over the years, so I was sorely missing a decent offline music player that can serve as a frontend for the collection. I tried several Mac apps over the years, but since streaming music is mainstream now, there aren't good offline music players that meet my needs. So I spent the last 3 months building Petrichor! The idea is to solve my problem and learn Swift UI development along the way, while giving back to the community with this open-source project! Here's a list of features it has, with more getting added in future;

- Everything you'd expect from an offline music player!

- Map your music folders and browse your library in an organised view.

- Create playlists and manage the play queue interactively.

- Browse music using folder view when needed.

- Pin anything (almost!) to the sidebar for quick access to your favourite music.

- Navigate easily: right-click a track to go to its album, artist, year, etc.

- Native macOS integration with menubar and dock playback controls, plus dark mode support.

- Search quickly through large libraries containing thousands of songs.

The app is still in alpha, so things may look unpolished, but I've been testing the alpha builds for the past few weeks and fixing issues as I find them for v1 release. I welcome any feedback (and contributions!) on GitHub repo. Please give it a try and let me know what you think!

tianqi

The most issues I encounter with music players are related to my situation of NAS. My NAS is straightforward: I just connect a RAID to a Mac and share it, then let other Macs connect to this "server". This allows me to access it in Finder like any other directory. However, this setup presents two obvious problems for many players: First, since the directory is not always available (if I'm not at home), some players cannot properly handle the issue of the main directory not existing. Second, I need to easily synchronise playlists across different computers, but many players do not support saving playlists as files, specifying their save location onto NAS, and configuring themselves to read playlists from NAS. These issues have been causing me a great deal of frustration. Currently I use VOX, which is a fairly acceptable option. I hope I can find a better solution.

ale42

I don't own a Mac, so I wont use it directly, but I use Macs from time to time, and it looks great! +1 (or +10) for being native code made with Swift and not the x-th HTML/JS-based program that eats your RAM :-)

kawsper

I’ve been searching for something like this, I love the name!

I currently use iTunes, and I might be an idiot, but I don’t seem to be able to export/import my library between installs, so I lose my plays and settings, but I never lose music files!

I have a massive music library and mostly just listen on shuffle, but it would be cool to be able to sync to my iPhone.

I’ll try all the recommendations in this thread!

dewey

If you are looking for a “old school iTunes” kind of player there’s also https://swinsian.com/

gpm

The Readme mentions that app under "Motivation"

> Motivation

> I have a large collection of music files that I’ve gathered over the years, and I missed having a good offline music player on macOS. I used Swinsian (great app, by the way!), but it hasn't been updated in years. I also missed features commonly found in streaming apps; so I built Petrichor to scratch that itch and learn Swift and macOS app development along the way!

thek3nger

For the people interested, Swinsian has a beta version that is actively developed. I got an update a couple of weeks ago. So it is not abandoned.

Meekro

Thanks for the recommendation! This one's the best "old school iTunes" program I've tried so far. I might stick with this one for now. I especially like how I can make smartlists with nested rules.

The main thing I'm missing is volume leveling.

bigyabai

quodlibet comes highly recommended for Windows/Linux users that want a more retro media player: https://github.com/quodlibet/quodlibet

Meekro

I've been searching for the perfect "old school iTunes" program for a while. I'm pretty sure it does not exist, maybe I'll try to make one someday unless someone beats me to it? Here's what I want:

* Smartlists, preferably with nested rules

* Proper search, the way iTunes did it: you have a huge excel-like list of songs that filters as you type

* Volume leveling

* Corresponding Windows/Mac/iPhone programs, with the ability to sync my collection like Dropbox

I would gladly pay $100 for this.

blef

I don't have my own music collection, but because of this I'd consider finding a way to have it to switch away from online providers.

Cenk

If you’re looking for a “iTunes before it went to shit” vibe I can also recommend Doppler: https://brushedtype.co/doppler/

Meekro

Thanks for the recommendation! I gave it a try, but unfortunately this one doesn't have the stuff that I liked from old-school iTunes. At first glance: no smart lists; search doesn't work the way I want (I want a giant excel-like list that filters as I type); no volume leveling.

eviks

> Everything you'd expect from an offline music player!

I'd expect winamp-level UI customization, cross-platform support, iTunes library smart playlist support...

syspec

Ah, I guess he was talking to the person behind you

pinoy420

[dead]

8mobile

Congrats for Petrichor, really impressive work! I love the clean, modern UI. I’m currently using Swinsian (still solid in many ways), but Petrichor feels like a breath of fresh air, especially for those of us who still care about local libraries. I truly hope you’ll bring this to iOS. Thanks

newscracker

Two suggestions, if you have the time to look at the effort and difficulty to implement them:

> P.S. I plan publish it on Homebrew soon.

1. Please consider publishing on MacPorts too.

2. Please consider supporting m4b audiobooks (it’s a different file extension from the common m4a, but also supports chapters).

beschizza

Without even looking at anything else, I love the name.

gpm

Anyone want to let me in on the joke/reference/pun/pronunciation/why it's a clever name?

kushalpandya

There you go https://en.wikipedia.org/wiki/Petrichor

> Petrichor is the earthy scent produced when rain falls on dry soil.

null

[deleted]

johng

It's actually my favorite scent in the world. I grew up in New Mexico.

null

[deleted]

null

[deleted]

jzellis

I'm not in front of my laptop but I'm gonna download it later, as I've got a 128GB SD card filled with my middle aged white guy hipster music library that I also keep on an actual 5G iPod Classic (which I added SD storage to and keep meaning to also add a Bluetooth module to as well).

A thought, because of all the folks asking for volume limiting: if you're not into DSP, it might be easier to simply add a point in your audio output flow for AudioUnits and let people use one of the existing limiters for it - Apple just straight up includes one on every Mac in the AudioUnits library - or write one specifically and include it.

This would also allow not just limiting but EQ, compression or even simulated tube warmth if people wanted that. (Or, y'know, running everything through autotune and a bit crusher if they're psychopaths. :-D)

I've never coded in Swift but I imagine adding a point to route through AudioUnits is probably not hugely difficult and iirc Apple has example code for doing it, at least they used to.

Keep up the awesome work, either way!