PyPI - spolyrics - Versions diffs - 1.2.0__tar.gz → 1.2.2__tar.gz - Mend

spolyrics 1.2.0tar.gz → 1.2.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

{spolyrics-1.2.0 → spolyrics-1.2.2}/LICENSE RENAMED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2026 paturrr
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2026 paturrr
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{spolyrics-1.2.0/spolyrics.egg-info → spolyrics-1.2.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spolyrics
-Version: 1.2.0
+Version: 1.2.2
 Summary: A minimalist, borderless, zero-delay synced lyrics miniplayer for Spotify on Windows.
 Author: SpoLyrics Team
 Requires-Python: >=3.8
@@ -25,7 +25,8 @@ Dynamic: summary
 <h1 align="center">SpoLyrics</h1>
 <p align="center">
-  <em>A minimalist, transparent, and zero-delay Spotify lyrics miniplayer.</em>
+  <em>A minimalist, transparent, and zero-delay Spotify lyrics miniplayer.</em><br>
+  <strong>🌐 <a href="https://paturrr.github.io/SpoLyrics/">Visit the Official Website</a></strong>
 </p>
 <p align="center">
@@ -75,6 +76,9 @@ I built this project to solve a specific complaint from my friends: they wanted
 - **Advanced Customization (Settings)**
   Change lyrics color using a modern real-time custom HSV color picker, adjust window transparency (opacity), and enable "Auto-Start with Windows". All configurations are permanently saved.
+- **Auto Update Checker**
+  Automatically checks for the newest version on PyPI when you launch the app, offering a seamless one-click update and restart experience.
 ## Invisible Controls

{spolyrics-1.2.0 → spolyrics-1.2.2}/README.md RENAMED Viewed

@@ -1,126 +1,130 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/paturrr/SpoLyrics/main/icon.ico" width="150" alt="SpoLyrics Logo">
-</p>
-<h1 align="center">SpoLyrics</h1>
-<p align="center">
-  <em>A minimalist, transparent, and zero-delay Spotify lyrics miniplayer.</em>
-</p>
-<p align="center">
-  <img src="https://img.shields.io/github/stars/paturrr/SpoLyrics.svg?style=flat-square&color=1DB954&label=stars&logo=github&logoColor=white" alt="Stars">
-  <img src="https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-1DB954?style=flat-square&logo=python&logoColor=white" alt="Python Versions">
-  <img src="https://img.shields.io/badge/OS-Windows%2010%2F11-1DB954?style=flat-square&logo=windows&logoColor=white" alt="Windows Only">
-  <img src="https://img.shields.io/badge/%F0%9F%93%9C_License-MIT-1DB954?style=flat-square" alt="MIT license">
-</p>
-<p align="center">
-  <strong>0-Delay Sync &middot; Native Windows API &middot; Glassmorphism UI &middot; Invisible Controls</strong><br>
-  <sub>Built with Python & Windows System Media Transport Controls for 100% precision.</sub>
-</p>
-<p align="center">
-  <img src="https://raw.githubusercontent.com/paturrr/SpoLyrics/main/assets/1.png" alt="SpoLyrics Transparent UI & Lyrics Sync">
-  <br><br>
-  <img src="https://raw.githubusercontent.com/paturrr/SpoLyrics/main/assets/2.png" alt="SpoLyrics Modern Settings & Shortcuts">
-</p>
----
-## Background & Feedback
-I built this project to solve a specific complaint from my friends: they wanted to listen to songs on Spotify or YouTube Music while working, but the official miniplayers didn't show any lyrics.
-**Note:** This application is still in active development! If you encounter any bugs, have a feature request, or just want to suggest an improvement, please don't hesitate to open an issue or let me know.
----
-## Key Features
-- **Zero-Delay Sync**
-  100% precise time synchronization. Pulls real-time duration data directly from the Windows OS core.
-- **Smart Duration Match**
-  Automatically matches lyrics based on the duration of the currently playing song version (solving the Radio Edit vs. Album Version mismatch).
-- **Glassmorphism UI**
-  Elegant, transparent, and borderless design.
-- **Freely Draggable**
-  Left-click and hold anywhere to drag the lyrics window wherever you like.
-- **System Tray Integration**
-  Runs quietly in the background. Right-click the system tray icon (SpoLyrics logo) to access settings, hide the lyrics, or view shortcuts.
-- **Advanced Customization (Settings)**
-  Change lyrics color using a modern real-time custom HSV color picker, adjust window transparency (opacity), and enable "Auto-Start with Windows". All configurations are permanently saved.
-## Invisible Controls
-This application uses zero conventional buttons to keep the UI perfectly clean. Use these mouse gestures:
-- `Right Click`: Play / Pause
-- `Mouse Scroll (Up/Down)`: Next / Previous track
-- `Middle Click (Scroll Wheel or 3-Finger Tap on Touchpad)`: Toggle Pin / Lock Window
-  - *When locked, the resize icon changes to a padlock (🔒) and the app ignores all drags/clicks to prevent accidental touches. Middle click again to unlock.*
-- `Ctrl + Left Click`: Toggle song title visibility
-- `Ctrl + Mouse Scroll`: Increase / Decrease font size
-- `Drag Bottom Right Corner (⇲)`: Resize the window
-- `Double Left Click`: Close the application
-## Installation
-Run this single command in your Windows Terminal or Command Prompt (Requires **Python 3.8 to 3.12**):
-> **Note on Python Version:** Do NOT use Python 3.13. The required `winsdk` package does not yet have pre-compiled binaries for Python 3.13 and will fail to install. Please stick to Python 3.12 or older.
-```bash
-pip install spolyrics
-```
-*(If you get a `pip is not recognized` error, use this alternative command instead:)*
-```bash
-python -m pip install spolyrics
-```
-> **IMPORTANT (OS Support):**
-> This app is **Exclusive to Windows**. Because it uses `winsdk` (Windows System Media Transport Controls) to achieve 0-delay performance without third-party servers, it **CANNOT** be installed on macOS or Linux.
-### Alternative Installation (Manual)
-If you prefer to download the source code manually (e.g., as a `.zip` file) instead of using the direct `git` command above, you must install the required dependencies (the "shopping list") yourself.
-Open your terminal inside the `SpoLyrics` folder and run:
-```bash
-pip install -r requirements.txt
-```
-## Usage
-Once installed, you can launch the app from any directory by typing:
-```bash
-spolyrics
-```
-Or, if you want it to run smoothly without spawning a black background terminal:
-```bash
-pythonw -m main
-```
-*(Make sure Spotify or your Windows media player is running and playing a song!)*
-## Updating
-To update the application to the latest version, run:
-```bash
-pip install --upgrade spolyrics
-```
-## Uninstallation
-If you wish to remove this application from your computer, simply run:
-```bash
-pip uninstall spolyrics
-```
-## License
-This project is licensed under the [MIT License](LICENSE) - see the LICENSE file for details.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/paturrr/SpoLyrics/main/icon.ico" width="150" alt="SpoLyrics Logo">
+</p>
+<h1 align="center">SpoLyrics</h1>
+<p align="center">
+  <em>A minimalist, transparent, and zero-delay Spotify lyrics miniplayer.</em><br>
+  <strong>🌐 <a href="https://paturrr.github.io/SpoLyrics/">Visit the Official Website</a></strong>
+</p>
+<p align="center">
+  <img src="https://img.shields.io/github/stars/paturrr/SpoLyrics.svg?style=flat-square&color=1DB954&label=stars&logo=github&logoColor=white" alt="Stars">
+  <img src="https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-1DB954?style=flat-square&logo=python&logoColor=white" alt="Python Versions">
+  <img src="https://img.shields.io/badge/OS-Windows%2010%2F11-1DB954?style=flat-square&logo=windows&logoColor=white" alt="Windows Only">
+  <img src="https://img.shields.io/badge/%F0%9F%93%9C_License-MIT-1DB954?style=flat-square" alt="MIT license">
+</p>
+<p align="center">
+  <strong>0-Delay Sync &middot; Native Windows API &middot; Glassmorphism UI &middot; Invisible Controls</strong><br>
+  <sub>Built with Python & Windows System Media Transport Controls for 100% precision.</sub>
+</p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/paturrr/SpoLyrics/main/assets/1.png" alt="SpoLyrics Transparent UI & Lyrics Sync">
+  <br><br>
+  <img src="https://raw.githubusercontent.com/paturrr/SpoLyrics/main/assets/2.png" alt="SpoLyrics Modern Settings & Shortcuts">
+</p>
+---
+## Background & Feedback
+I built this project to solve a specific complaint from my friends: they wanted to listen to songs on Spotify or YouTube Music while working, but the official miniplayers didn't show any lyrics.
+**Note:** This application is still in active development! If you encounter any bugs, have a feature request, or just want to suggest an improvement, please don't hesitate to open an issue or let me know.
+---
+## Key Features
+- **Zero-Delay Sync**
+  100% precise time synchronization. Pulls real-time duration data directly from the Windows OS core.
+- **Smart Duration Match**
+  Automatically matches lyrics based on the duration of the currently playing song version (solving the Radio Edit vs. Album Version mismatch).
+- **Glassmorphism UI**
+  Elegant, transparent, and borderless design.
+- **Freely Draggable**
+  Left-click and hold anywhere to drag the lyrics window wherever you like.
+- **System Tray Integration**
+  Runs quietly in the background. Right-click the system tray icon (SpoLyrics logo) to access settings, hide the lyrics, or view shortcuts.
+- **Advanced Customization (Settings)**
+  Change lyrics color using a modern real-time custom HSV color picker, adjust window transparency (opacity), and enable "Auto-Start with Windows". All configurations are permanently saved.
+- **Auto Update Checker**
+  Automatically checks for the newest version on PyPI when you launch the app, offering a seamless one-click update and restart experience.
+## Invisible Controls
+This application uses zero conventional buttons to keep the UI perfectly clean. Use these mouse gestures:
+- `Right Click`: Play / Pause
+- `Mouse Scroll (Up/Down)`: Next / Previous track
+- `Middle Click (Scroll Wheel or 3-Finger Tap on Touchpad)`: Toggle Pin / Lock Window
+  - *When locked, the resize icon changes to a padlock (🔒) and the app ignores all drags/clicks to prevent accidental touches. Middle click again to unlock.*
+- `Ctrl + Left Click`: Toggle song title visibility
+- `Ctrl + Mouse Scroll`: Increase / Decrease font size
+- `Drag Bottom Right Corner (⇲)`: Resize the window
+- `Double Left Click`: Close the application
+## Installation
+Run this single command in your Windows Terminal or Command Prompt (Requires **Python 3.8 to 3.12**):
+> **Note on Python Version:** Do NOT use Python 3.13. The required `winsdk` package does not yet have pre-compiled binaries for Python 3.13 and will fail to install. Please stick to Python 3.12 or older.
+```bash
+pip install spolyrics
+```
+*(If you get a `pip is not recognized` error, use this alternative command instead:)*
+```bash
+python -m pip install spolyrics
+```
+> **IMPORTANT (OS Support):**
+> This app is **Exclusive to Windows**. Because it uses `winsdk` (Windows System Media Transport Controls) to achieve 0-delay performance without third-party servers, it **CANNOT** be installed on macOS or Linux.
+### Alternative Installation (Manual)
+If you prefer to download the source code manually (e.g., as a `.zip` file) instead of using the direct `git` command above, you must install the required dependencies (the "shopping list") yourself.
+Open your terminal inside the `SpoLyrics` folder and run:
+```bash
+pip install -r requirements.txt
+```
+## Usage
+Once installed, you can launch the app from any directory by typing:
+```bash
+spolyrics
+```
+Or, if you want it to run smoothly without spawning a black background terminal:
+```bash
+pythonw -m main
+```
+*(Make sure Spotify or your Windows media player is running and playing a song!)*
+## Updating
+To update the application to the latest version, run:
+```bash
+pip install --upgrade spolyrics
+```
+## Uninstallation
+If you wish to remove this application from your computer, simply run:
+```bash
+pip uninstall spolyrics
+```
+## License
+This project is licensed under the [MIT License](LICENSE) - see the LICENSE file for details.

{spolyrics-1.2.0 → spolyrics-1.2.2}/main.py RENAMED Viewed

@@ -12,8 +12,10 @@ import logging
 import sqlite3
 from datetime import datetime, timezone
 from assets import ICON_B64
+from tkinter import messagebox
 from winsdk.windows.media.control import GlobalSystemMediaTransportControlsSessionManager as MediaManager
+CURRENT_VERSION = "1.2.2"
 CONFIG_PATH = os.path.join(os.environ.get("APPDATA", ""), "SpoLyrics", "config.json")
 APP_DIR = os.path.join(os.environ.get("APPDATA", ""), "SpoLyrics")
 os.makedirs(APP_DIR, exist_ok=True)
@@ -85,19 +87,25 @@ def save_config(config):
     with open(CONFIG_PATH, 'w') as f:
         json.dump(config, f)
-def set_auto_start(enable):
+def get_exe_path():
+    import sys
+    if getattr(sys, 'frozen', False):
+        return sys.executable
+    script_exe = os.path.join(sys.prefix, 'Scripts', 'spolyrics.exe')
+    if os.path.exists(script_exe):
+        return script_exe
+    return sys.executable
+def set_auto_start(enable, force_update=False):
     try:
         if enable:
             app_dir = os.path.join(os.environ.get("APPDATA", ""), "SpoLyrics")
             icon_path = os.path.join(app_dir, 'icon.ico')
-            import sys
-            if getattr(sys, 'frozen', False):
-                exe_path = sys.executable
-            else:
-                exe_path = shutil.which('spolyrics') or sys.executable
+            exe_path = get_exe_path()
             if exe_path and os.path.exists(icon_path):
-                ps_script = f"$s=(New-Object -COM WScript.Shell).CreateShortcut('{STARTUP_SHORTCUT}');$s.TargetPath='{exe_path}';$s.IconLocation='{icon_path}';$s.Save()"
-                subprocess.run(["powershell", "-Command", ps_script], creationflags=0x08000000)
+                if force_update or not os.path.exists(STARTUP_SHORTCUT):
+                    ps_script = f"$s=(New-Object -COM WScript.Shell).CreateShortcut('{STARTUP_SHORTCUT}');$s.TargetPath='{exe_path}';$s.IconLocation='{icon_path}';$s.Save()"
+                    subprocess.run(["powershell", "-Command", ps_script], creationflags=0x08000000)
         else:
             if os.path.exists(STARTUP_SHORTCUT):
                 os.remove(STARTUP_SHORTCUT)
@@ -130,7 +138,7 @@ class MiniLyrics:
         self.is_pinned = False
         self.show_title = True
-        self.lbl_title = tk.Label(self.root, text="", fg='#a0a0a0', bg='#191414', font=('Arial', 8, 'bold'), justify='center', wraplength=320)
+        self.lbl_title = tk.Label(self.root, text="", fg='#a0a0a0', bg='#191414', font=('Segoe UI', 8, 'bold'), justify='center', wraplength=320)
         self.lbl_title.place(relx=0.5, y=8, anchor='n')
         self.lbl_current = tk.Label(self.root, text="Waiting for song...", fg=self.config['color'], bg='#191414', font=('Arial', self.font_cur, 'bold'), wraplength=330, justify="center")
@@ -138,11 +146,16 @@ class MiniLyrics:
         self.lbl_next = tk.Label(self.root, text="", fg='#b3b3b3', bg='#191414', font=('Arial', self.font_nxt), wraplength=330, justify="center")
         self.lbl_next.pack(expand=True, fill='both', padx=10, pady=(0, 15))
+        self.update_available = False
+        self.root.after(2000, self.check_updates)
         self.grip = tk.Label(self.root, text="⇲", fg='#333333', bg='#191414', cursor="size_nw_se")
         self.grip.place(relx=1.0, rely=1.0, anchor="se")
         self.grip.bind("<B1-Motion>", self.on_resize)
+        self.grip.bind("<Enter>", lambda e: not self.is_pinned and self.grip.config(fg='#888888'))
+        self.grip.bind("<Leave>", lambda e: not self.is_pinned and self.grip.config(fg='#333333'))
         self.root.bind("<B1-Motion>", self.drag)
         self.root.bind("<Button-1>", self.click)
         self.root.bind("<Double-1>", lambda e: not self.is_pinned and self.root.destroy())
@@ -248,6 +261,16 @@ class MiniLyrics:
     def on_scroll(self, event):
         if self.is_pinned: return "break"
+        now = time.time()
+        if not hasattr(self, 'last_scroll_time'):
+            self.last_scroll_time = 0
+        if now - self.last_scroll_time < 0.8:
+            return "break"
+        self.last_scroll_time = now
         if event.delta > 0: self.media_control('prev')
         else: self.media_control('next')
         return "break"
@@ -270,7 +293,7 @@ class MiniLyrics:
         self.info_win = tk.Toplevel(self.root)
         self.info_win.title("SpoLyrics Info")
-        self.info_win.geometry("340x400")
+        self.info_win.geometry("420x400")
         self.info_win.configure(bg='#191414')
         self.info_win.attributes('-topmost', True)
         self.info_win.overrideredirect(True)
@@ -337,7 +360,7 @@ class MiniLyrics:
         self.settings_win = tk.Toplevel(self.root)
         self.settings_win.title("SpoLyrics Settings")
-        self.settings_win.geometry("380x410")
+        self.settings_win.geometry("380x520")
         self.settings_win.configure(bg='#191414')
         self.settings_win.attributes('-topmost', True)
         self.settings_win.resizable(False, False)
@@ -350,27 +373,29 @@ class MiniLyrics:
             self.settings_win.destroy()
         self.settings_win.protocol("WM_DELETE_WINDOW", on_settings_close)
-        tk.Label(self.settings_win, text="SpoLyrics Settings", fg='white', bg='#191414', font=('Segoe UI', 16, 'bold')).pack(pady=(20, 15))
+        header_frame = tk.Frame(self.settings_win, bg='#191414')
+        header_frame.pack(fill='x', padx=25, pady=(20, 15))
+        tk.Label(header_frame, text="Settings", fg='white', bg='#191414', font=('Segoe UI', 18, 'bold')).pack(side='left')
-        info_lbl = tk.Label(self.settings_win, text="❔", fg='#888888', bg='#191414', font=('Segoe UI', 12), cursor='hand2')
-        info_lbl.place(x=340, y=20)
+        info_lbl = tk.Label(header_frame, text="❔", fg='#888888', bg='#191414', font=('Segoe UI', 12), cursor='hand2')
+        info_lbl.pack(side='right', pady=(5,0))
         info_lbl.bind("<Button-1>", lambda e: self.open_info())
         info_lbl.bind("<Enter>", lambda e: info_lbl.config(fg='white'))
         info_lbl.bind("<Leave>", lambda e: info_lbl.config(fg='#888888'))
-        # --- Color Picker ---
-        color_frame = tk.Frame(self.settings_win, bg='#191414')
-        color_frame.pack(fill='x', padx=30, pady=5)
+        tk.Label(self.settings_win, text="APPEARANCE", fg='#888888', bg='#191414', font=('Segoe UI', 8, 'bold')).pack(anchor='w', padx=25, pady=(0, 5))
+        app_card = tk.Frame(self.settings_win, bg='#242424')
+        app_card.pack(fill='x', padx=25, pady=(0, 15))
-        tk.Label(color_frame, text="Lyrics Color", fg='#b3b3b3', bg='#191414', font=('Segoe UI', 11, 'bold')).pack(side='left')
+        color_frame = tk.Frame(app_card, bg='#242424')
+        color_frame.pack(fill='x', padx=15, pady=12)
+        tk.Label(color_frame, text="Lyrics Color", fg='#e0e0e0', bg='#242424', font=('Segoe UI', 10)).pack(side='left')
         self.current_hex = self.config['color']
-        color_btn = tk.Frame(color_frame, bg=self.current_hex, width=50, height=25, cursor='hand2', highlightbackground='#333333', highlightthickness=1)
+        color_btn = tk.Frame(color_frame, bg=self.current_hex, width=24, height=24, cursor='hand2', highlightbackground='#555', highlightthickness=1)
         color_btn.pack(side='right')
-        # --- Ultra Modern Inline Sliders ---
-        palette_frame = tk.Frame(self.settings_win, bg='#191414')
+        palette_frame = tk.Frame(app_card, bg='#1e1e1e')
         self.palette_visible = False
         import colorsys
@@ -378,8 +403,8 @@ class MiniLyrics:
             rgb = colorsys.hls_to_rgb(h, l, s)
             return "#{:02x}{:02x}{:02x}".format(int(rgb[0]*255), int(rgb[1]*255), int(rgb[2]*255))
-        tk.Label(palette_frame, text="Hue (Warna):", fg='#888', bg='#191414', font=('Segoe UI', 9)).pack(anchor='w', padx=5)
-        hue_canvas = tk.Canvas(palette_frame, width=240, height=12, bg='#191414', highlightthickness=0, cursor='hand2')
+        tk.Label(palette_frame, text="Hue:", fg='#888', bg='#1e1e1e', font=('Segoe UI', 8)).pack(anchor='w', padx=15, pady=(10,2))
+        hue_canvas = tk.Canvas(palette_frame, width=240, height=12, bg='#1e1e1e', highlightthickness=0, cursor='hand2')
         hue_canvas.pack(pady=(0, 5))
         for i in range(120):
@@ -387,9 +412,9 @@ class MiniLyrics:
             hue_canvas.create_rectangle(i*2, 0, (i+1)*2, 12, fill=c, outline=c)
         hue_thumb = hue_canvas.create_rectangle(0, 0, 4, 12, fill='white', outline='black')
-        tk.Label(palette_frame, text="Lightness (Kecerahan):", fg='#888', bg='#191414', font=('Segoe UI', 9)).pack(anchor='w', padx=5)
-        lit_canvas = tk.Canvas(palette_frame, width=240, height=12, bg='#191414', highlightthickness=0, cursor='hand2')
-        lit_canvas.pack(pady=(0, 5))
+        tk.Label(palette_frame, text="Lightness:", fg='#888', bg='#1e1e1e', font=('Segoe UI', 8)).pack(anchor='w', padx=15, pady=(5,2))
+        lit_canvas = tk.Canvas(palette_frame, width=240, height=12, bg='#1e1e1e', highlightthickness=0, cursor='hand2')
+        lit_canvas.pack(pady=(0, 10))
         lit_rects = []
         for i in range(120):
@@ -397,10 +422,10 @@ class MiniLyrics:
             lit_rects.append(r)
         lit_thumb = lit_canvas.create_rectangle(120, 0, 124, 12, fill='black', outline='white')
-        custom_frame = tk.Frame(palette_frame, bg='#191414')
-        custom_frame.pack(pady=(5,0))
-        tk.Label(custom_frame, text="Hex:", fg='#888', bg='#191414', font=('Segoe UI', 9)).pack(side='left')
-        hex_entry = tk.Entry(custom_frame, width=9, bg='#282828', fg='white', insertbackground='white', relief='flat', justify='center')
+        custom_frame = tk.Frame(palette_frame, bg='#1e1e1e')
+        custom_frame.pack(pady=(0, 15))
+        tk.Label(custom_frame, text="Hex:", fg='#888', bg='#1e1e1e', font=('Segoe UI', 9)).pack(side='left')
+        hex_entry = tk.Entry(custom_frame, width=9, bg='#333', fg='white', insertbackground='white', relief='flat', justify='center')
         hex_entry.insert(0, self.current_hex)
         hex_entry.pack(side='left', padx=5)
@@ -446,41 +471,39 @@ class MiniLyrics:
         def toggle_palette(e=None):
             if not self.palette_visible:
-                self.settings_win.geometry("380x540")
+                self.settings_win.geometry("380x680")
                 update_lit_canvas()
-                palette_frame.pack(fill='x', padx=30, after=color_frame)
+                palette_frame.pack(fill='x', after=color_frame)
                 hex_entry.delete(0, 'end')
                 hex_entry.insert(0, self.current_hex)
             else:
-                self.settings_win.geometry("380x410")
+                self.settings_win.geometry("380x520")
                 palette_frame.pack_forget()
             self.palette_visible = not self.palette_visible
         color_btn.bind("<Button-1>", toggle_palette)
-        # --- Opacity Slider ---
-        op_frame = tk.Frame(self.settings_win, bg='#191414')
-        op_frame.pack(fill='x', padx=30, pady=(15, 0))
+        tk.Frame(app_card, height=1, bg='#333').pack(fill='x', padx=15)
-        tk.Label(op_frame, text="Window Opacity", fg='#b3b3b3', bg='#191414', font=('Segoe UI', 11, 'bold')).pack(side='left')
-        tk.Label(op_frame, text="(Normal: 85%)", fg='#666666', bg='#191414', font=('Segoe UI', 9)).pack(side='left', padx=5, pady=(2,0))
+        op_frame = tk.Frame(app_card, bg='#242424')
+        op_frame.pack(fill='x', padx=15, pady=12)
+        tk.Label(op_frame, text="Window Opacity", fg='#e0e0e0', bg='#242424', font=('Segoe UI', 10)).pack(side='left')
         self.cur_op = self.config.get('opacity', 0.85)
-        op_val_lbl = tk.Label(op_frame, text=f"{int(self.cur_op*100)}%", fg='white', bg='#191414', font=('Segoe UI', 10, 'bold'))
+        op_val_lbl = tk.Label(op_frame, text=f"{int(self.cur_op*100)}%", fg='#888', bg='#242424', font=('Segoe UI', 9, 'bold'))
         op_val_lbl.pack(side='right')
-        op_canvas = tk.Canvas(self.settings_win, width=320, height=14, bg='#191414', highlightthickness=0, cursor='hand2')
-        op_canvas.pack(pady=(5, 15))
-        op_canvas.create_rectangle(0, 5, 320, 9, fill='#333333', outline='#333333')
-        op_fill = op_canvas.create_rectangle(0, 5, int(self.cur_op*320), 9, fill='#1DB954', outline='#1DB954')
-        th_x = int(self.cur_op*320)
+        op_canvas = tk.Canvas(app_card, width=330, height=14, bg='#242424', highlightthickness=0, cursor='hand2')
+        op_canvas.pack(pady=(0, 15))
+        op_canvas.create_rectangle(20, 5, 310, 9, fill='#333', outline='#333', width=0)
+        op_fill = op_canvas.create_rectangle(20, 5, int(self.cur_op*290)+20, 9, fill='#1DB954', outline='#1DB954', width=0)
+        th_x = int(self.cur_op*290)+20
         op_thumb = op_canvas.create_oval(th_x-6, 1, th_x+6, 13, fill='white', outline='white')
         def on_op_drag(e):
-            x = max(32, min(e.x, 320)) # min 10% opacity
-            self.cur_op = x / 320.0
-            op_canvas.coords(op_fill, 0, 5, x, 9)
+            x = max(20+29, min(e.x, 310))
+            self.cur_op = (x-20) / 290.0
+            op_canvas.coords(op_fill, 20, 5, x, 9)
             op_canvas.coords(op_thumb, x-6, 1, x+6, 13)
             op_val_lbl.config(text=f"{int(self.cur_op*100)}%")
             self.root.attributes('-alpha', self.cur_op)
@@ -488,20 +511,22 @@ class MiniLyrics:
         op_canvas.bind("<B1-Motion>", on_op_drag)
         op_canvas.bind("<Button-1>", on_op_drag)
-        # --- Auto Start Toggle ---
-        toggle_frame = tk.Frame(self.settings_win, bg='#191414')
-        toggle_frame.pack(fill='x', padx=30, pady=5)
+        tk.Label(self.settings_win, text="SYSTEM", fg='#888888', bg='#191414', font=('Segoe UI', 8, 'bold')).pack(anchor='w', padx=25, pady=(5, 5))
+        sys_card = tk.Frame(self.settings_win, bg='#242424')
+        sys_card.pack(fill='x', padx=25, pady=(0, 15))
-        tk.Label(toggle_frame, text="Auto-start Windows", fg='#b3b3b3', bg='#191414', font=('Segoe UI', 11, 'bold')).pack(side='left')
+        toggle_frame = tk.Frame(sys_card, bg='#242424')
+        toggle_frame.pack(fill='x', padx=15, pady=12)
+        tk.Label(toggle_frame, text="Auto-start Windows", fg='#e0e0e0', bg='#242424', font=('Segoe UI', 10)).pack(side='left')
         class ToggleSwitch(tk.Canvas):
             def __init__(self, parent, initial_state=False, *args, **kwargs):
-                tk.Canvas.__init__(self, parent, width=46, height=24, bg='#191414', highlightthickness=0, cursor='hand2', *args, **kwargs)
+                tk.Canvas.__init__(self, parent, width=40, height=20, bg='#242424', highlightthickness=0, cursor='hand2', *args, **kwargs)
                 self.is_on = initial_state
-                self.track = self.create_oval(2, 2, 22, 22, fill="#555", outline="#555")
-                self.track2 = self.create_oval(24, 2, 44, 22, fill="#555", outline="#555")
-                self.rect = self.create_rectangle(12, 2, 34, 22, fill="#555", outline="#555")
-                self.thumb = self.create_oval(4, 4, 20, 20, fill="white", outline="white")
+                self.track = self.create_oval(2, 2, 18, 18, fill="#555", outline="#555")
+                self.track2 = self.create_oval(22, 2, 38, 18, fill="#555", outline="#555")
+                self.rect = self.create_rectangle(10, 2, 30, 18, fill="#555", outline="#555")
+                self.thumb = self.create_oval(4, 4, 16, 16, fill="white", outline="white")
                 self.bind("<Button-1>", self.toggle)
                 self._update_ui()
@@ -514,35 +539,35 @@ class MiniLyrics:
                     self.itemconfig(self.track, fill="#1DB954", outline="#1DB954")
                     self.itemconfig(self.track2, fill="#1DB954", outline="#1DB954")
                     self.itemconfig(self.rect, fill="#1DB954", outline="#1DB954")
-                    self.coords(self.thumb, 26, 4, 42, 20)
+                    self.coords(self.thumb, 24, 4, 36, 16)
                 else:
-                    self.itemconfig(self.track, fill="#555555", outline="#555555")
-                    self.itemconfig(self.track2, fill="#555555", outline="#555555")
-                    self.itemconfig(self.rect, fill="#555555", outline="#555555")
-                    self.coords(self.thumb, 4, 4, 20, 20)
+                    self.itemconfig(self.track, fill="#555", outline="#555")
+                    self.itemconfig(self.track2, fill="#555", outline="#555")
+                    self.itemconfig(self.rect, fill="#555", outline="#555")
+                    self.coords(self.thumb, 4, 4, 16, 16)
         toggle = ToggleSwitch(toggle_frame, initial_state=self.config['auto_start'])
         toggle.pack(side='right')
-        # --- Cache Info ---
-        cache_frame = tk.Frame(self.settings_win, bg='#191414')
-        cache_frame.pack(fill='x', padx=30, pady=5)
-        tk.Label(cache_frame, text="Lyrics Cache", fg='#b3b3b3', bg='#191414', font=('Segoe UI', 11, 'bold')).pack(side='left')
+        tk.Frame(sys_card, height=1, bg='#333').pack(fill='x', padx=15)
+        cache_frame = tk.Frame(sys_card, bg='#242424')
+        cache_frame.pack(fill='x', padx=15, pady=12)
+        tk.Label(cache_frame, text="Lyrics Cache", fg='#e0e0e0', bg='#242424', font=('Segoe UI', 10)).pack(side='left')
         def get_db_size():
             try:
                 if os.path.exists(CACHE_DB_PATH):
                     size_bytes = os.path.getsize(CACHE_DB_PATH)
-                    if size_bytes >= 1024 * 1024:
-                        return f"{size_bytes / (1024 * 1024):.2f} MB"
-                    else:
-                        return f"{size_bytes / 1024:.2f} KB"
-            except Exception:
-                pass
+                    if size_bytes >= 1024 * 1024: return f"{size_bytes / (1024 * 1024):.2f} MB"
+                    else: return f"{size_bytes / 1024:.2f} KB"
+            except Exception: pass
             return "0.00 KB"
-        cache_size_lbl = tk.Label(cache_frame, text=get_db_size(), fg='white', bg='#191414', font=('Segoe UI', 10))
+        del_btn = tk.Label(cache_frame, text="Clear", bg='#333', fg='#ff4444', font=('Segoe UI', 8, 'bold'), padx=8, pady=2, cursor='hand2')
+        del_btn.pack(side='right')
+        cache_size_lbl = tk.Label(cache_frame, text=get_db_size(), fg='#888', bg='#242424', font=('Segoe UI', 9))
         cache_size_lbl.pack(side='right', padx=(0, 10))
         def delete_cache(e=None):
@@ -558,14 +583,10 @@ class MiniLyrics:
             except Exception as ex:
                 logging.error("Failed to delete cache", exc_info=ex)
-        del_btn = tk.Label(cache_frame, text="Clear", bg='#e91429', fg='white', font=('Segoe UI', 9, 'bold'), padx=10, pady=2, cursor='hand2')
-        del_btn.pack(side='right')
         del_btn.bind("<Button-1>", delete_cache)
-        # --- Separator ---
-        tk.Frame(self.settings_win, height=1, bg='#282828').pack(fill='x', padx=30, pady=10)
+        del_btn.bind("<Enter>", lambda e: del_btn.config(bg='#ff4444', fg='white'))
+        del_btn.bind("<Leave>", lambda e: del_btn.config(bg='#333', fg='#ff4444'))
-        # --- Save Button ---
         def save_and_apply(e=None):
             self.config['color'] = self.current_hex
             self.config['auto_start'] = toggle.is_on
@@ -580,15 +601,12 @@ class MiniLyrics:
             self.settings_win.protocol("WM_DELETE_WINDOW", lambda: None)
             self.root.after(100, lambda: self.settings_win.destroy() if self.settings_win.winfo_exists() else None)
-        def on_enter(e): save_btn.config(bg='#1ed760')
-        def on_leave(e): save_btn.config(bg='#1DB954')
-        save_btn = tk.Label(self.settings_win, text="Save & Apply", bg='#1DB954', fg='white', font=('Segoe UI', 11, 'bold'), pady=8, cursor='hand2')
-        save_btn.pack(fill='x', padx=40, pady=(0, 20))
+        save_btn = tk.Label(self.settings_win, text="Save & Apply", bg='#1DB954', fg='white', font=('Segoe UI', 10, 'bold'), pady=8, cursor='hand2')
+        save_btn.pack(fill='x', padx=25, pady=(5, 20))
         save_btn.bind("<Button-1>", save_and_apply)
-        save_btn.bind("<Enter>", on_enter)
-        save_btn.bind("<Leave>", on_leave)
+        save_btn.bind("<Enter>", lambda e: save_btn.config(bg='#1ed760'))
+        save_btn.bind("<Leave>", lambda e: save_btn.config(bg='#1DB954'))
     def media_control(self, action):
         if self.is_pinned: return "break"
@@ -706,7 +724,7 @@ class MiniLyrics:
                             if song_id != self.current_song:
                                 self.current_song = song_id
                                 self.root.after(0, lambda sid=song_id: self.lbl_title.config(text=sid if self.show_title else ""))
-                                self.root.after(0, self.update_ui, f"Matching smart lyrics...\n{song_id}", "")
+                                self.root.after(0, self.update_ui, "Loading lyrics... ⏳", "")
                                 async def fetch_and_apply(sid, t, a, d):
                                     await asyncio.sleep(0.5)
@@ -724,7 +742,7 @@ class MiniLyrics:
                         if self.current_song:
                             self.current_song = ""
                             self.synced_lyrics = []
-                            self.root.after(0, self.update_ui, "Tidak ada lagu diputar.", "")
+                            self.root.after(0, self.update_ui, "No song playing.", "")
                 except Exception as e:
                     logging.error("Error in poll_song loop", exc_info=e)
@@ -733,7 +751,47 @@ class MiniLyrics:
         asyncio.run(main_loop())
+    def check_updates(self):
+        def _check():
+            try:
+                resp = requests.get('https://pypi.org/pypi/spolyrics/json', timeout=5).json()
+                latest = resp['info']['version']
+                if latest != CURRENT_VERSION:
+                    self.root.after(0, self.show_update_prompt, latest)
+            except Exception as e:
+                logging.error("Failed to check for updates", exc_info=e)
+        threading.Thread(target=_check, daemon=True).start()
+    def prompt_update(self):
+        if self.update_available:
+            self.show_update_prompt(self.update_available)
+    def show_update_prompt(self, latest):
+        self.update_available = latest
+        if getattr(self, 'tray_icon', None):
+            self.tray_icon.update_menu()
+        res = messagebox.askyesno("Update Available", f"A new version of SpoLyrics (v{latest}) is available!\n\nYou are currently on v{CURRENT_VERSION}.\nWould you like to update now?")
+        if res:
+            import tempfile
+            bat_path = os.path.join(tempfile.gettempdir(), "update_spolyrics.bat")
+            exe_path = get_exe_path()
+            with open(bat_path, 'w') as f:
+                f.write('@echo off\n')
+                f.write('echo Updating SpoLyrics...\n')
+                f.write('ping 127.0.0.1 -n 3 > nul\n')
+                f.write('python -m pip install --upgrade spolyrics\n')
+                f.write(f'start "" "{exe_path}"\n')
+                f.write('del "%~f0"\n')
+            subprocess.Popen(['cmd.exe', '/c', bat_path], creationflags=16)
+            if getattr(self, 'tray_icon', None):
+                self.tray_icon.stop()
+            self.root.quit()
+            import sys
+            sys.exit(0)
 def create_shortcut():
+    path_changed = False
     try:
         shortcut_path = os.path.join(os.environ.get("APPDATA", ""), "Microsoft", "Windows", "Start Menu", "Programs", "SpoLyrics.lnk")
         app_dir = os.path.join(os.environ.get("APPDATA", ""), "SpoLyrics")
@@ -750,17 +808,26 @@ def create_shortcut():
         if not os.path.exists(shortcut_path):
             needs_update = True
+        exe_path = get_exe_path()
+        path_file = os.path.join(app_dir, 'current_exe_path.txt')
+        saved_path = ""
+        if os.path.exists(path_file):
+            with open(path_file, 'r') as f:
+                saved_path = f.read().strip()
+        if saved_path != exe_path:
+            needs_update = True
+            path_changed = True
+            with open(path_file, 'w') as f:
+                f.write(exe_path)
         if needs_update:
-            import sys
-            if getattr(sys, 'frozen', False):
-                exe_path = sys.executable
-            else:
-                exe_path = shutil.which('spolyrics') or sys.executable
             if exe_path:
                 ps_script = f"$s=(New-Object -COM WScript.Shell).CreateShortcut('{shortcut_path}');$s.TargetPath='{exe_path}';$s.IconLocation='{icon_path}';$s.Save()"
                 subprocess.run(["powershell", "-Command", ps_script], creationflags=0x08000000)
     except Exception as e:
         logging.error("Failed to create shortcut", exc_info=e)
+    return path_changed
 def setup_tray(app):
     try:
@@ -789,27 +856,54 @@ def setup_tray(app):
             logging.error("Failed to open tray icon image, using fallback", exc_info=e)
             image = Image.new('RGB', (64, 64), color = (29, 185, 84))
-        menu = pystray.Menu(
-            pystray.MenuItem("Shortcuts & Info", on_info),
-            pystray.MenuItem("Settings", on_settings),
-            pystray.MenuItem("Toggle Visibility", on_toggle_lyrics),
-            pystray.MenuItem("Quit", on_quit)
-        )
-        icon = pystray.Icon("SpoLyrics", image, "SpoLyrics", menu)
+        def get_menu():
+            items = [
+                pystray.MenuItem("Shortcuts & Info", on_info),
+                pystray.MenuItem("Settings", on_settings),
+                pystray.MenuItem("Toggle Visibility", on_toggle_lyrics),
+                pystray.MenuItem("Quit", on_quit),
+                pystray.MenuItem(f"v{CURRENT_VERSION}", lambda: None, enabled=False)
+            ]
+            if getattr(app, 'update_available', False):
+                items.insert(0, pystray.MenuItem("🔥 Update Available!", lambda: app.root.after(0, app.prompt_update)))
+            return pystray.Menu(*items)
+        icon = pystray.Icon("SpoLyrics", image, "SpoLyrics", menu=get_menu)
+        app.tray_icon = icon
         threading.Thread(target=icon.run, daemon=True).start()
     except Exception as e:
         logging.error("Tray icon failed to load", exc_info=e)
+def check_single_instance():
+    mutex_name = "Global\\SpoLyrics_Mutex"
+    mutex = ctypes.windll.kernel32.CreateMutexW(None, False, mutex_name)
+    last_error = ctypes.windll.kernel32.GetLastError()
+    if last_error == 183:
+        from tkinter import messagebox
+        import sys
+        temp_root = tk.Tk()
+        temp_root.withdraw()
+        temp_root.attributes('-topmost', True)
+        res = messagebox.askyesno("Already Running", "SpoLyrics is already running in the background.\n\nAre you sure you want to open another instance?", parent=temp_root)
+        temp_root.destroy()
+        if not res:
+            sys.exit(0)
+    return mutex
 def start_app():
+    global _app_mutex
+    _app_mutex = check_single_instance()
     try:
         ctypes.windll.shcore.SetProcessDpiAwareness(1)
     except Exception as e:
         logging.error("Failed to set DPI awareness", exc_info=e)
+        logging.error("Failed to set DPI awareness", exc_info=e)
-    create_shortcut()
+    path_changed = create_shortcut()
     config = load_config()
-    set_auto_start(config['auto_start'])
+    set_auto_start(config['auto_start'], force_update=path_changed)
     app = MiniLyrics(config)
     setup_tray(app)

{spolyrics-1.2.0 → spolyrics-1.2.2}/setup.py RENAMED Viewed

@@ -2,7 +2,7 @@ from setuptools import setup
 setup(
     name='spolyrics',
-    version='1.2.0',
+    version='1.2.2',
     description='A minimalist, borderless, zero-delay synced lyrics miniplayer for Spotify on Windows.',
     long_description=open('README.md', 'r', encoding='utf-8').read(),
     long_description_content_type='text/markdown',

{spolyrics-1.2.0 → spolyrics-1.2.2/spolyrics.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spolyrics
-Version: 1.2.0
+Version: 1.2.2
 Summary: A minimalist, borderless, zero-delay synced lyrics miniplayer for Spotify on Windows.
 Author: SpoLyrics Team
 Requires-Python: >=3.8
@@ -25,7 +25,8 @@ Dynamic: summary
 <h1 align="center">SpoLyrics</h1>
 <p align="center">
-  <em>A minimalist, transparent, and zero-delay Spotify lyrics miniplayer.</em>
+  <em>A minimalist, transparent, and zero-delay Spotify lyrics miniplayer.</em><br>
+  <strong>🌐 <a href="https://paturrr.github.io/SpoLyrics/">Visit the Official Website</a></strong>
 </p>
 <p align="center">
@@ -75,6 +76,9 @@ I built this project to solve a specific complaint from my friends: they wanted
 - **Advanced Customization (Settings)**
   Change lyrics color using a modern real-time custom HSV color picker, adjust window transparency (opacity), and enable "Auto-Start with Windows". All configurations are permanently saved.
+- **Auto Update Checker**
+  Automatically checks for the newest version on PyPI when you launch the app, offering a seamless one-click update and restart experience.
 ## Invisible Controls

{spolyrics-1.2.0 → spolyrics-1.2.2}/assets.py RENAMED Viewed

File without changes

{spolyrics-1.2.0 → spolyrics-1.2.2}/setup.cfg RENAMED Viewed

File without changes

{spolyrics-1.2.0 → spolyrics-1.2.2}/spolyrics.egg-info/SOURCES.txt RENAMED Viewed

File without changes

{spolyrics-1.2.0 → spolyrics-1.2.2}/spolyrics.egg-info/dependency_links.txt RENAMED Viewed

File without changes

{spolyrics-1.2.0 → spolyrics-1.2.2}/spolyrics.egg-info/entry_points.txt RENAMED Viewed

File without changes

{spolyrics-1.2.0 → spolyrics-1.2.2}/spolyrics.egg-info/requires.txt RENAMED Viewed

File without changes

{spolyrics-1.2.0 → spolyrics-1.2.2}/spolyrics.egg-info/top_level.txt RENAMED Viewed

File without changes

spolyrics 1.2.0__tar.gz → 1.2.2__tar.gz

spolyrics 1.2.0tar.gz → 1.2.2tar.gz