Fnote V3
FNote v3
Your Personal, Offline-First Music Library.
Built for Creators, Curators, and You.
View Demo • Getting Started • Read the Story
📖 About
FNote is a modern, performant, and feature-rich cross-platform music player built for the desktop. Designed to be fast, minimal, and secure, FNote leverages the power of Rust and the flexibility of web technologies to deliver a premium audio experience without the bloat.
Key Features (Planned)
| ⚡️ Performance | 🔒 Security | 🎨 Experience |
|---|---|---|
| Native Rust backend for minimal memory footprint. | Offline-first architecture. Your data stays on your machine. | Beautiful, focused UI built with Tailwind CSS. |
📸 User Interface Preview
FNote v3 leverages the UI/UX design of its predecessor, providing a beautiful, focused experience in a dedicated desktop wrapper.
📜 The FNote Saga: Coded by AI
🤖 AI-Native Development: FNote v3 is the third iteration of a passion project started at the beginning of my coding journey. This project has been built almost entirely using large language models (LLMs).
After numerous attempts and valuable lessons learned, FNote v3 represents a commitment to stability, performance, and modern architecture.
⏳ Version History
| Version | Core Tech | Frontend | The Story |
|---|---|---|---|
| FNote v1 | Python |
Tkinter |
My first major project. Simple, functional, but source code is lost. Read Story |
| FNote v2 | Python |
Vanilla JS |
The Designer. Excellent UI/UX, but suffered from instability and resource heaviness. Read Story |
| FNote v3 | Rust |
SvelteKit |
The Modern Rewrite. Focused on performance, security, and fixing the flaws of v2. |
🦀 Why Tauri?
The jump to Tauri was crucial. By compiling the application core to efficient, memory-safe Rust, FNote v3 aims to solve the heavy footprint and instability issues that plagued FNote v2, while retaining a rapid development workflow on the frontend with SvelteKit.
🚧 Current Status: Pre-Alpha
This repository currently focuses solely on the architecture and frontend presentation.
[!WARNING]
There is currently no fully functional audio playback or file handling. FNote v3 aims to achieve feature parity with the bug-ridden FNote v2, depending on the capabilities of current and future AI assistants.
Development Milestones:
- UI Complete: Interface components based on v2 design (SvelteKit + Tailwind).
- IPC Wired: Frontend connected to Rust backend via Tauri commands.
- Data Mocked: Rust core holds mock data/state.
- Audio Engine: File streaming and playback controls.
- Database: Local library management.
⚙️ Tech Stack
FNote v3 leverages a modern, high-performance stack:
| Layer | Technology | Icon | Purpose |
|---|---|---|---|
| Backend | Rust | Security, performance, and system interaction. | |
| Shell | Tauri | Cross-platform bundling and native APIs. | |
| Frontend | SvelteKit | Highly reactive and lightweight UI. | |
| Styling | Tailwind | Utility-first modern design. |
🚀 Getting Started
To run FNote v3 locally, ensure you have the prerequisites installed.
Prerequisites
Installation & Run
# 1. Clone the repository
git clone https://github.com/zqily/FNote-v3.git
cd FNote-v3
# 2. Install SvelteKit dependencies
npm install
# 3. Start the Tauri development server
# This launches the Rust backend and the SvelteKit frontend with hot-reloading
npm run tauri
