chore: bump version to 0.3.3

Author: aFFekopp

README.md

@@ -1,40 +1,63 @@
 # FretLog 🎸
 
-FretLog is a personal music practice dashboard designed to help musicians track their progress, manage their repertoire, and maintain a consistent practice routine.
+FretLog is a personal music practice dashboard designed to help musicians track their progress, manage their repertoire, and maintain a consistent practice routine. It combines a minimal practice timer with powerful statistics and visual progress trackers.
+
+![Dashboard Preview](public/screenshots/dashboard.png)
 
 ## Project Status: Vibe Coded
 > [!IMPORTANT]
 > This project is **heavily vibe coded** and primarily intended for **personal use**. 
-> It was built with a focus on immediate utility and specific workflow "vibes". While functional and feature-rich, it may not follow traditional professional software architecture patterns. It works for me, and it might work for you!
+> It was built with a focus on immediate utility and my specific workflow. While functional and feature-rich, it may not follow traditional professional software architecture patterns. It works for me, and it might work for you!
 
-## Features
-- **Dashboard**: Quick overview of your practice streak, total time, and recent sessions.
-- **Active Timer**: Start a practice session and track time for specific items in your library.
-- **Library Management**: Organize your songs, exercises, and techniques by category and artist.
-- **Detailed Statistics**: Visualize your progress with GitHub-style activity heatmaps and trend charts.
-- **Session History**: Review and manage past practice logs with detailed notes.
-- **Customizable**: Add your own instruments and practice categories.
-- **Dark Mode**: Sleek, modern interface that's easy on the eyes.
+## Key Features
+- **📊 Interactive Dashboard**: Quick overview of your practice streak, total time, and recent sessions.
+- **⏱️ Active Session Timer**: Start a practice session and track time for specific items in your library with a non-intrusive global timer.
+- **📱 PWA Ready**: Install FretLog on your phone or desktop for a native-like experience.
+- **📈 Detailed Statistics**: Visualize your progress with GitHub-style activity heatmaps, category distributions, and practice trend charts.
+- **📚 Repertoire Library**: Organize your songs, exercises, and techniques with ratings, notes, and artist grouping.
+- **🎸 Instrument Management**: Support for multiple instruments (Guitar, Bass, Piano, etc.).
+- **☁️ Data Sovereignty**: Full JSON Export/Import capabilities and a single-user SQLite backend for privacy.
+- **🌙 Modern UI**: A sleek, dark-mode-first interface optimized for both desktop and mobile use.
 
-## Deployment with Docker
-The easiest way to run FretLog is using Docker Compose.
+## Screenshots
 
-1. **Clone the repo**:
-   ```bash
-   git clone https://github.com/aFFekopp/fretlog.git
-   cd fretlog
+| Dashboard | Sessions |
+|:---:|:---:|
+| ![Dashboard](public/screenshots/dashboard.png) | ![Sessions](public/screenshots/sessions.png) |
+
+| Statistics | Library |
+|:---:|:---:|
+| ![Statistics](public/screenshots/statistics.png) | ![Library](public/screenshots/library.png) |
+
+## Deployment with Docker Compose
+The easiest way to run FretLog is using Docker Compose with the pre-built image.
+
+1. **Create a `docker-compose.yml` file**:
+   ```yaml
+   services:
+     fretlog:
+       image: ghcr.io/affekopp/fretlog:latest
+       container_name: fretlog
+       restart: unless-stopped
+       ports:
+         - "5000:5000"
+       volumes:
+         - ./data:/app/data
    ```
-2. **Start the app**:
+
+2. **Start the application**:
    ```bash
    docker-compose up -d
    ```
+
 3. **Access FretLog**:
    Open [http://localhost:5000](http://localhost:5000) in your browser.
 
 ## Tech Stack
 - **Backend**: Python (Flask), SQLite
-- **Frontend**: Vanilla JS, HTML5, CSS3 (Modern Flex/Grid)
+- **Frontend**: Vanilla JS, HTML5, CSS3 (Modern Flex/Grid), Chart.js
+- **PWA**: Service Workers, Web Manifest
 - **Deployment**: Docker, GHCR, GitHub Actions
 
 ## License
-Intended for personal use. Feel free to fork and adapt it to your own practice vibes.
+Intended for personal use. Feel free to fork and adapt it to your needs.

public/screenshots/dashboard.png

@@ -40,9 +40,7 @@ def init_db():
     cursor = conn.cursor()
 
     # Tables
-    cursor.execute('''CREATE TABLE IF NOT EXISTS users (
-        id TEXT PRIMARY KEY, name TEXT, email TEXT, avatar TEXT, 
-        default_instrument_id TEXT, created_at TEXT)''')
+    cursor.execute('DROP TABLE IF EXISTS users')
 
     cursor.execute('''CREATE TABLE IF NOT EXISTS categories (
         id TEXT PRIMARY KEY, name TEXT, type TEXT, icon TEXT, color TEXT)''')
@@ -69,7 +67,7 @@ def init_db():
         key TEXT PRIMARY KEY, value TEXT)''')
 
     # Default data if empty
-    cursor.execute('SELECT count(*) FROM users')
+    cursor.execute('SELECT count(*) FROM instruments')
     if cursor.fetchone()[0] == 0:
         init_default_data(conn)
 
@@ -78,9 +76,6 @@ def init_db():
 
 def init_default_data(conn):
     cursor = conn.cursor()
-    user_id = generate_id()
-    cursor.execute('INSERT INTO users (id, name, created_at) VALUES (?, ?, ?)', 
-                   (user_id, 'Musician', datetime.now().isoformat()))
 
     # Default Categories
     cats = [
@@ -105,8 +100,8 @@ def init_default_data(conn):
         cursor.execute('INSERT INTO instruments (id, name, icon) VALUES (?, ?, ?)',
                        (inst_id, name, icon))
 
-    # Set default instrument for user
-    cursor.execute('UPDATE users SET default_instrument_id=? WHERE id=?', ('inst-guitar', user_id))
+    # Set default instrument
+    cursor.execute("INSERT OR REPLACE INTO settings (key, value) VALUES ('default_instrument_id', ?)", ('inst-guitar',))
 
     conn.commit()
 
@@ -116,18 +111,20 @@ def inject_user():
         conn = get_db()
         cursor = conn.cursor()
 
-        # Get User
-        cursor.execute('SELECT * FROM users LIMIT 1')
-        user_row = cursor.fetchone()
-        user = dict(user_row) if user_row else None
+        # Get Current Instrument ID from settings
+        cursor.execute("SELECT value FROM settings WHERE key='default_instrument_id'")
+        row = cursor.fetchone()
+        instrument_id = row[0] if row else 'inst-guitar'
 
         # Get Current Instrument
         instrument = None
-        if user and user.get('default_instrument_id'):
-            cursor.execute('SELECT * FROM instruments WHERE id=?', (user['default_instrument_id'],))
-            inst_row = cursor.fetchone()
-            if inst_row:
-                instrument = dict(inst_row)
+        cursor.execute('SELECT * FROM instruments WHERE id=?', (instrument_id,))
+        inst_row = cursor.fetchone()
+        if inst_row:
+            instrument = dict(inst_row)
+        
+        # current_user is now a dummy object for template compatibility
+        user = {'id': 'local-user', 'name': 'Musician'}
 
         return dict(current_user=user, current_instrument=instrument)
     except Exception as e:
@@ -180,9 +177,11 @@ def get_init_data():
     conn = get_db()
     cursor = conn.cursor()
 
-    # User
-    cursor.execute('SELECT * FROM users LIMIT 1')
-    user = dict_from_row(cursor.fetchone())
+    # User (Dummy for compatibility)
+    user = {'id': 'local-user', 'name': 'Musician'}
+    cursor.execute("SELECT value FROM settings WHERE key='default_instrument_id'")
+    inst_row = cursor.fetchone()
+    user['default_instrument_id'] = inst_row[0] if inst_row else 'inst-guitar'
 
     # Categories
     cursor.execute('SELECT * FROM categories')
@@ -239,34 +238,13 @@ def get_init_data():
 # ==========================================
 @app.route('/api/user', methods=['GET'])
 def get_user():
-    conn = get_db()
-    cursor = conn.cursor()
-    cursor.execute('SELECT * FROM users LIMIT 1')
-    user = dict_from_row(cursor.fetchone())
-    conn.close()
+    user = {'id': 'local-user', 'name': 'Musician'}
     return jsonify(user)
 
 @app.route('/api/user', methods=['POST', 'PUT'])
 def update_user():
-    data = request.json
-    conn = get_db()
-    cursor = conn.cursor()
-    
-    cursor.execute('SELECT id FROM users LIMIT 1')
-    user = cursor.fetchone()
-    
-    if user:
-        cursor.execute('''
-            UPDATE users SET name=?, email=?, avatar=?, default_instrument_id=?
-            WHERE id=?
-        ''', (data.get('name'), data.get('email'), data.get('avatar'), 
-              data.get('defaultInstrumentId'), user[0]))
-    
-    conn.commit()
-    cursor.execute('SELECT * FROM users WHERE id=?', (user[0],))
-    updated_user = dict_from_row(cursor.fetchone())
-    conn.close()
-    return jsonify(updated_user)
+    # Users table is gone, just return dummy
+    return jsonify({'id': 'local-user', 'name': 'Musician'})
 
 # ==========================================
 # Categories API
@@ -880,6 +858,25 @@ def set_theme():
     conn.close()
     return jsonify({'theme': data.get('theme')})
 
+@app.route('/api/settings', methods=['POST'])
+def update_setting():
+    data = request.json
+    key = data.get('key')
+    value = data.get('value')
+    
+    if not key:
+        return jsonify({'error': 'Missing key'}), 400
+        
+    conn = get_db()
+    cursor = conn.cursor()
+    cursor.execute('''
+        INSERT OR REPLACE INTO settings (key, value) VALUES (?, ?)
+    ''', (key, value))
+    conn.commit()
+    conn.close()
+    
+    return jsonify({'status': 'success', 'key': key, 'value': value})
+
 # ==========================================
 # Statistics API
 # ==========================================
@@ -931,7 +928,7 @@ def export_data():
     conn = get_db()
     cursor = conn.cursor()
 
-    tables = ['users', 'categories', 'instruments', 'artists', 'library_items', 'sessions', 'session_items', 'settings']
+    tables = ['categories', 'instruments', 'artists', 'library_items', 'sessions', 'session_items', 'settings']
     export = {}
 
     for table in tables:
@@ -1017,18 +1014,12 @@ def import_data():
                 cursor.execute('INSERT OR REPLACE INTO settings (key, value) VALUES (?, ?)',
                                (setting['key'], setting['value']))
 
-        # 8. User (optional, might want to keep current)
-        if 'users' in data and data['users']:
-            user = data['users'][0]
-            cursor.execute('''
-                INSERT OR REPLACE INTO users (id, name, email, avatar, default_instrument_id, created_at)
-                VALUES (?, ?, ?, ?, ?, ?)
-            ''', (user['id'], user['name'], user.get('email', ''), user.get('avatar'), 
-                  user.get('default_instrument_id'), user['created_at']))
+        # 8. Table 'users' is no longer imported
 
         conn.commit()
         return jsonify({'status': 'success', 'message': 'Data imported successfully'})
     except Exception as e:
+        print(f"Error importing data: {e}")
         conn.rollback()
         return jsonify({'error': str(e)}), 500
     finally:
@@ -1041,16 +1032,16 @@ def clear_data():
     cursor = conn.cursor()
 
     try:
-        # Preserve user info
-        cursor.execute('SELECT name, email, default_instrument_id FROM users LIMIT 1')
-        user_row = cursor.fetchone()
-        preserved_user = dict(user_row) if user_row else {'name': 'Musician', 'email': '', 'default_instrument_id': None}
-        
         # Preserve theme
         cursor.execute("SELECT value FROM settings WHERE key='theme'")
         theme_row = cursor.fetchone()
         preserved_theme = theme_row[0] if theme_row else 'dark'
 
+        # Preserve instrument
+        cursor.execute("SELECT value FROM settings WHERE key='default_instrument_id'")
+        inst_row = cursor.fetchone()
+        preserved_inst = inst_row[0] if inst_row else 'inst-guitar'
+        
         # Delete everything
         cursor.execute('DELETE FROM session_items')
         cursor.execute('DELETE FROM sessions')
@@ -1059,26 +1050,18 @@ def clear_data():
         cursor.execute('DELETE FROM categories')
         cursor.execute('DELETE FROM instruments')
         cursor.execute('DELETE FROM settings')
-        cursor.execute('DELETE FROM users')
 
         conn.commit()
 
         # Re-initialize with defaults
         init_default_data(conn)
 
-        # Restore preserved data
-        # Update user (id will be newly generated by init_default_data if we deleted all, but init_db usually handles this)
-        # Actually init_default_data adds a NEW user if count is 0. 
-        # Let's check how many users now
-        cursor.execute('SELECT id FROM users LIMIT 1')
-        new_user = cursor.fetchone()
-        if new_user:
-            cursor.execute('UPDATE users SET name=?, email=?, default_instrument_id=? WHERE id=?',
-                           (preserved_user['name'], preserved_user['email'], preserved_user['default_instrument_id'], new_user[0]))
-        
         # Restore theme
         cursor.execute("INSERT OR REPLACE INTO settings (key, value) VALUES ('theme', ?)", (preserved_theme,))
 
+        # Restore instrument
+        cursor.execute("INSERT OR REPLACE INTO settings (key, value) VALUES ('default_instrument_id', ?)", (preserved_inst,))
+        
         conn.commit()
         return jsonify({'status': 'success', 'message': 'All data cleared except defaults and profile'})
     except Exception as e:
@@ -1087,6 +1070,14 @@ def clear_data():
     finally:
         conn.close()
 
+@app.route('/manifest.json')
+def serve_manifest():
+    return send_from_directory('static', 'manifest.json')
+
+@app.route('/sw.js')
+def serve_sw():
+    return send_from_directory('static', 'sw.js')
+
 if __name__ == '__main__':
     with app.app_context():
         init_db()

public/screenshots/library.png

@@ -93,13 +93,11 @@ function updateUserInfo() {
         } catch (e) { console.warn('Failed to parse cached instruments', e); }
     }
 
-    const userName = document.getElementById('user-name');
     const userInstrument = document.getElementById('user-instrument');
     const userAvatar = document.getElementById('user-avatar');
 
-    if (userName) userName.textContent = user?.name || 'Musician';
     if (userInstrument) userInstrument.textContent = instrument?.name || 'Guitar';
-    if (userAvatar) userAvatar.textContent = (user?.name || 'M').charAt(0).toUpperCase();
+    if (userAvatar && instrument) userAvatar.textContent = instrument.icon || '🎸';
 }
 
 // ==========================================