Jul 21, 2025 21:00:00

Petrichor is a free offline music player for macOS

Petrichor, an offline music player for macOS, has been developed as open source software under the MIT license and is available on GitHub. Petrichor supports file formats such as MP3, M4A, WAV, AAC, AIFF, and FLAC, and can map music folders to browse the library.

kushalpandya/Petrichor: An offline macOS music player

https://github.com/kushalpandya/Petrichor

'I have a huge collection of music files that I've collected over the years, and I was missing a good offline music player on macOS. I used to use a great app called Swinsian , but it hasn't been updated in years. I also missed the features that are common in streaming apps, so I started developing Petrichor while learning Swift and macOS app development,' said Kushal Pandya, developer of Petrichor.

Petrichor can be installed as a package via Homebrew tap, and a disk image file has been released on GitHub. The requirement is 'macOS 14 or later.'

Releases · kushalpandya/Petrichor
https://github.com/kushalpandya/Petrichor/releases

Petrichor loads and displays music files from the folders registered in the library. Music playback is performed by AVFoundation .

Songs displayed by artist look like this. Petrichor allows you to pin almost anything to the sidebar for quick access to your favorite music. You can also right-click on a track to navigate to the album, artist, year, etc. However, since song data is retrieved from metadata rather than online, you must register metadata in your music files before you can use Petrichor's features.

Playlists can also be created. Track lookup is performed by

SQLite FTS5 with fallback to in-memory lookup.

The 'General' settings look like this. The color mode can be set to three patterns: light, dark, and automatic.

You can add multiple folders to your library. Once a folder is added, Petrichor will scan it and use GRDB to populate the SQLite database. Petrichor never modifies your music files, it just reads them from the directories you add.

Pandya lists some of the features he would like to see in Petrichor in the future, including 'smart playlists with user-configurable conditional filters,' 'audio equalizer,' 'support for file formats such as Opus and OGG,' 'AirPlay 2 casting support,' 'mini player and full-screen mode,' 'automatic in-app updates,' and 'album and artist information fetching from the internet.'