https://github.com/probablykasper/ferrum

Music library app for Mac, Linux and Windows
https://github.com/probablykasper/ferrum

electron linux macos music music-library music-player napi windows

Last synced: 8 months ago
JSON representation

Music library app for Mac, Linux and Windows

• Host: GitHub
• URL: https://github.com/probablykasper/ferrum
• Owner: probablykasper
• Created: 2020-03-19T01:59:08.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2025-07-04T06:14:09.000Z (8 months ago)
• Last Synced: 2025-07-04T07:18:46.226Z (8 months ago)
• Topics: electron, linux, macos, music, music-library, music-player, napi, windows
• Language: Svelte
• Homepage: https://ferrum.kasper.space
• Size: 199 MB
• Stars: 51
• Watchers: 3
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

          


	



Ferrum



	Music library and player

	


	Download for Mac, Windows or Linux






![Screenshot](assets/screenshot.png)

## Features

- Playlists & folders

- Filtering

- Queue

- Metadata editing

- Fast. Navigation, sorting & filtering should be instant even for libraries with 100 000 tracks

- Quick playlist navigation with CmdK or CtrlK

## Dev instructions

### Get started

1. Install Node.js

2. Install Rust

3. Run `npm install`

### Structure

App (Electron)

- Source: `src/electron.js` and `src/electron/`

- Build output: `build/app/`

Web (the frontend)

- Source code: napi and `src/`

- Build output: `build/web/`

Napi (the native Rust backend)

- Source code: `src-native/`

- Build output: `ferrum-addon/addon.node`

### Commands

- `npm run dev`: Start app in dev mode

- `npm run dev-release`: Start app in dev mode (optimized)

- `npm run build`: Build

- `npm run lint`: Lint

- `npm run format`: Format