βœ“
Petrichor Download

Offline macOS music player (14+) built with Swift supporting wide audio formats (MP3, AAC, WAV, FLAC, Opus, DSF/DFF, etc.), featuring folder mapping, playlist/queue management, folder browsing, sidebar pinning, native menubar/dock controls, dark mode, audio equalizer, sandboxed Apple notarization, and MIT license.

⭐ 1,123 stars on GitHub
Latest Release: v1.2.3

About Software

Petrichor is an offline music player for macOS providing everything expected from offline music player. Supports wide variety of audio file formats (MP3, AAC/M4A, WAV, AIFF, AIF, ALAC, Ogg Vorbis, Speex, Opus, FLAC, APE Monkey's Audio, MPC Musepack, TTA True Audio, WV WavPack, DSF/DFF Direct Stream Digital, MOD, IT, S3M, XM, and AU). Map music folders and browse library in organized view. Create playlists and manage play queue interactively. Browse music using folder view when needed. Pin anything (almost!) to sidebar for quick access to favorite music. Navigate easily: right-click track to go to album/artist/year/etc. Native macOS integration with menubar/dock playback controls plus dark mode support. Works well with large libraries containing thousands of songs. Tip: Petrichor relies heavily on tracks having good metadata for all features to work well.

Upcoming features include AirPlay 2 casting support, miniplayer and full-screen modes, smart playlists with user-configurable conditional filters, online album & artist information fetching, and much more. Already completed (v1.0.0+): automatic in-app updates, better file format support (Opus & OGG v1.2.0), audio equalizer (v1.2.0). Requirements: macOS 14 or later. Installation manually via GitHub Releases .dmg (drag app into Applications, right-click > Open) or via Homebrew (brew install --cask petrichor). Privacy & data access: sandboxed and notarized by Apple, two permissions (read-only access to user-selected files/folders, network access to check/install updates), no analytics on app usage, never changes audio files or folder structure, library data remains offline always. Motivation: large collection of music files gathered over years, missed good offline music player on macOS, used several free/paid options but missed simplicity and features from streaming apps, built Petrichor to scratch that itch and learn Swift/macOS app development. MIT license.

Use Cases:

  • Offline macOS music player (14+) supporting wide variety of formats: MP3, AAC/M4A, WAV, AIFF, ALAC, Ogg Vorbis, Speex, Opus, FLAC, APE, MPC, TTA, WV, DSF/DFF, MOD, IT, S3M, XM, AU
  • Map music folders and browse library in organized view with playlist creation, interactive play queue, and folder view browsing
  • Pin anything to sidebar for quick favorites access, right-click tracks to navigate to album/artist/year, and native macOS integration
  • Menubar/dock playback controls, dark mode support, audio equalizer (v1.2.0+), and handles large libraries with thousands of songs
  • Sandboxed and notarized by Apple with read-only file access, network for updates, no analytics, never changes files, offline library data

Downloads

v1.2.3 November 27, 2025
Petrichor-1.2.3-Universal.dmgdmg
v1.2.2 November 20, 2025
Petrichor-1.2.2-Universal.dmgdmg
v1.2.0 November 16, 2025
Petrichor-1.2.0-Universal.dmgdmg
v1.1.4 November 04, 2025
Petrichor-1.1.4-Universal.dmgdmg
v1.1.3 October 20, 2025
Petrichor-1.1.3-Universal.dmgdmg
v1.1.2 October 09, 2025
Petrichor-1.1.2-Universal.dmgdmg
v1.1.1 October 02, 2025
Petrichor-1.1.1-Universal.dmgdmg
v1.1.0 September 18, 2025
Petrichor-1.1.0-Universal.dmgdmg
v1.0.1 September 01, 2025
Petrichor-1.0.1-Universal.dmgdmg
v1.0.0 August 23, 2025
Petrichor-1.0.0-Universal.dmgdmg
v1.0.0-beta-4 August 16, 2025
Petrichor-1.0.0-beta-4-Universal.dmgdmg
v1.0.0-beta-3 August 07, 2025
Petrichor-1.0.0-beta-3-Universal.dmgdmg
v1.0.0-beta-2 July 31, 2025
Petrichor-1.0.0-beta-2-Universal.dmgdmg
v1.0.0-beta-1 July 15, 2025
Petrichor-1.0.0-beta-1-Universal.dmgdmg
v1.0.0-alpha-4 July 12, 2025
Petrichor-1.0.0-alpha-4-Universal.dmgdmg
v1.0.0-alpha-3 July 10, 2025
Petrichor-1.0.0-alpha-3-Universal.dmgdmg
v1.0.0-alpha-2 July 09, 2025
Petrichor-1.0.0-alpha-2-Universal.dmgdmg
v1.0.0-alpha-1 July 08, 2025
Petrichor-1.0.0-alpha-1-Universal.dmgdmg

Package Info

Last Updated
Nov 27, 2025
Latest Version
v1.2.3
License
MIT
Total Versions
18

README

Petrichor An offline music player for macOS


Summary

✨ Features

  • Everything you'd expect from an offline music player!
  • Supports wide variety of audio file formats;
    • MP3, AAC/M4A, WAV, AIFF, AIF, ALAC
    • Ogg Vorbis, Speex, Opus, and FLAC
    • APE (Monkey's Audio)
    • MPC (Musepack)
    • TTA (True Audio)
    • WV (WavPack)
    • DSF/DFF (Direct Stream Digital)
    • ... MOD, IT, S3M, XM, and AU
  • Map your music folders and browse your library in an organized 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 favorite 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.
  • Works well with large libraries containing thousands of songs.

πŸ’‘ Tip: Petrichor relies heavily on tracks having good metadata for all its features to work well.

βŒ› Upcoming Features

  • Automatic in-app updates (βœ… v1.0.0 (https://github.com/kushalpandya/Petrichor/releases/tag/v1.0.0) )
  • Better file format support (eg; Opus & OGG) (βœ… v.1.2.0 (https://github.com/kushalpandya/Petrichor/releases/tag/v1.2.0))
  • Audio Equalizer (βœ… v.1.2.0 (https://github.com/kushalpandya/Petrichor/releases/tag/v1.2.0))
  • AirPlay 2 casting support
  • Miniplayer and full-screen modes
  • Smart playlists with user-configurable conditional filters
  • Online album & artist information fetching
  • ... and much more!

ο£Ώ Requirements

  • macOS 14 or later

βš™οΈ Installation

Manually

  • Go to Releases (https://github.com/kushalpandya/Petrichor/releases) and download the latest .dmg.
  • Open the it and drag the app icon into the Applications folder.
  • In Applications, right-click Petrichor > Open.

Homebrew

brew install --cask petrichor

πŸš€ Get Started

Petrichor User Guide (https://github.com/kushalpandya/Petrichor/wiki)

πŸ“· Screenshots

πŸ”’ Privacy & Data Access

  • Petrichor is sandboxed and notarized by Apple.
  • It has two permissions on macOS as follows;
    • Read-only access to user-selected files and folders
    • Network access to check and install updates
  • It doesn't (and never will) have any analytics on how you use the app.
  • It never changes your audio files or folder structure in any way.
  • Your library data remains offline always.

πŸ—οΈ Development

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've used several free and paid options but I missed the simplicity and features commonly found in streaming apps; so I built Petrichor to scratch that itch and learn Swift and macOS app development along the way!