Skip to content

Commit a21d7c3

Browse files
authored
Create README.md
1 parent 9177482 commit a21d7c3

File tree

1 file changed

+42
-0
lines changed

1 file changed

+42
-0
lines changed

README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# 🎵 Macan Audio Player
2+
3+
Macan Audio Player is a modern PyQt6-based audio player with support for various popular formats, powered by FFmpeg.
4+
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
5+
6+
---
7+
8+
## ✨ Key Features
9+
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
10+
- Auto-Sync Lyrics (.lrc)
11+
- Auto-follow lyrics to the song.
12+
- Manual scroll lock → auto-follow stops when the user swipes.
13+
- Toggle "Auto Follow Lyrics" via the menu.
14+
- Dark & ​​Light themes with modern accents.
15+
- Basic controls: Play, Pause, Seek (via slider).
16+
- Simple, lightweight, and clean UI.
17+
18+
---
19+
20+
## 📸 Screenshot
21+
<img width="854" height="629" alt="Screenshot 2025-08-22 212714" src="https://github.com/user-attachments/assets/adf6ac00-03e8-450e-abb3-bf485858b1a4" />
22+
23+
---
24+
25+
26+
## 📦 Installation
27+
1. Make sure **Python 3.10+** is installed.
28+
2. Install dependencies:
29+
```bash
30+
pip install PyQt6
31+
3. Make sure FFmpeg is installed and accessible via PATH.
32+
33+
---
34+
35+
📂 Note
36+
The source code shared is the base project.
37+
The full binary version (with the latest and stable features) is available in the Releases section.
38+
39+
---
40+
41+
📖 License
42+
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.

0 commit comments

Comments
 (0)