Skip to content

UnExplainableFish52/Fumic

Repository files navigation

🎵 Fumic

The Magical Media Player (FOSS)

A beautifully crafted, offline-first, keyboard-driven media player for Windows — built with Electron.

No ads. No telemetry. No nonsense. Just your music and videos, the way they should be.

License: GPL v3 Platform Made with Electron


✨ Features

Feature Description
⌨️ 100% Keyboard Control Navigate, play, seek, and manage everything without ever touching the mouse
🆓 FOSS — Free & Open Source Licensed under GPL v3. Free forever, no strings attached
📁 Multiple Formats Supports .mp3, .mp4, .opus, and .wav out of the box
🔒 100% Offline Zero telemetry, zero analytics, zero internet required
💪 Performance Playback Smooth audio & video playback powered by native HTML5 media
Minimalistic & Aesthetic Dark-themed, premium UI with micro-animations and glassmorphism
🎛️ Full Media Controls Shuffle, loop, seek, speed control, volume — all at your fingertips
Fast & Reliable Instant library scanning, lazy-loaded metadata, zero lag

⌨️ Keyboard Shortcuts

Fumic is designed to be used entirely from the keyboard. Here's the complete shortcut reference:

Playback

Shortcut Action
Space Play / Pause
Ctrl + Enter Play Selected Track
← / → Seek 5 seconds
Shift + ← / → Seek 10 seconds
Ctrl + ← / → Previous / Next Track
Shift + < / > Playback Speed Down / Up

Controls

Shortcut Action
Ctrl + ↑ / ↓ Volume Up / Down
Ctrl + M Mute / Unmute
Shift + S Toggle Shuffle
Shift + L Toggle Loop

Navigation

Shortcut Action
↑ / ↓ Navigate Media List
Ctrl + K Focus Search
Escape Unfocus Search / Exit Player
Ctrl + H Go to Home
Ctrl + S Go to Settings
Ctrl + I Go to Info
Ctrl + A Switch to Audio Tab
Ctrl + V Switch to Video Tab
Ctrl + F Toggle Full Screen Player

🚀 Getting Started

Prerequisites

  • Node.js (v18 or later)
  • npm (comes with Node.js)

Installation

# Clone the repository
git clone https://github.com/UnExplainableFish52/Fumic.git
cd Fumic

# Install dependencies
npm install

# Run in development mode
npm run dev

Building for Production

npm run build

The installer will be generated in the release/ directory.


❓ FAQ

Why Fumic?

Because no matter how much you look for, you won't find anything like this on the internet. A truly offline, keyboard-first, no-nonsense media player that just works.

Even if you do find something close, they will be behind paywalls or loaded with bloat you never asked for.

So Fumic is a lifesaver for you all. It was built out of genuine frustration and love for clean software.

Why FOSS?

FOSS means Free Open Source Software. It's not just a license, it's a philosophy.

Grew up using lots of tools and stuff, and now when I am able to contribute to the community, it's my chance — and so I did. Giving back feels right, and everyone deserves good tools without strings attached.

Who is the developer?

Legally responsible developer: TheIdealDev52 aka Saksham Sharma, along with Shelly (AI Agent).

A solo developer who believes software should be simple, fast, and free. Shelly helped bring the vision to life with precision and speed.

What license?

GNU General Public License v3.0

In simple terms:

  • ✅ Feel free to use
  • ✅ Feel free to modify
  • ✅ Feel free to share
  • 🚫 Never allowed to redistribute as proprietary — always must stay FOSS

The whole point is to keep it open forever. No one should lock this down behind a paywall.


🛣️ Roadmap

I'm open to contributions! Here are some upcoming features on the horizon:

  • 🎶 Music Visualizer — real-time audio visualization during playback
  • 📋 Playlists — create, save, and manage custom playlists
  • 🎨 Better UI — continuous refinement of the interface and user experience
  • 🐛 Minor Bug Fixes — polishing the rough edges

Have more ideas? I'd love to hear them!


🤝 Contributing

Contributions, bug reports, and feature suggestions are always welcome. Every bit of contribution counts.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m "Add amazing feature")
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

For further discussion, ideas, or just to say hi:

If you find Fumic useful, consider giving it a ⭐ — it genuinely helps with visibility and motivation!


Built with ❤️ by Saksham Sharma

Because good software should be free.