release: v0.8.19 Radio 睡眠定时器功能

- 新增 /radio 页面与音频播放器
- 新增睡眠定时器：30分钟/1小时/2小时循环切换，倒计时显示，归零自动暂停
- 新增 /api/radio/items 接口
- 支持音频文件扫描（AUDIO_EXTENSIONS）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: ChanMo

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "TikLocal"
-version = "0.8.18"
+version = "0.8.19"
 description = "A local media server that combines the features of TikTok and Pinterest"
 authors = ["ChanMo <chan.mo@outlook.com>"]
 readme = "README.md"

tiklocal/app.py

@@ -9,7 +9,7 @@
 from flask import Flask, render_template, send_from_directory, request, redirect, send_file
 
 # Service Imports
-from tiklocal.services import LibraryService, FavoriteService, RecommendService, IMAGE_EXTENSIONS
+from tiklocal.services import LibraryService, FavoriteService, RecommendService, IMAGE_EXTENSIONS, AUDIO_EXTENSIONS
 from tiklocal.services.thumbnail import ThumbnailService
 from tiklocal.services.metadata import (
     ImageMetadataStore,
@@ -284,6 +284,11 @@ def tiktok():
         """Immersive Mixed Media Feed"""
         return render_template('tiktok.html', menu='index')
 
+    @app.route('/radio')
+    def radio_view():
+        """Audio Radio Player"""
+        return render_template('radio.html', menu='radio')
+
     @app.route('/download')
     def download_view():
         """URL Download Center"""
@@ -519,6 +524,31 @@ def thumb_view():
 
 
     # --- API Routes ---
+    @app.route('/api/radio/items')
+    def api_radio_items():
+        offset = _read_int_arg('offset', 0, minimum=0)
+        limit = _read_int_arg('limit', 200, minimum=1, maximum=500)
+        audios = library_service.scan_audios()
+        favorites = favorite_service.load()
+        total = len(audios)
+        page = audios[offset:offset + limit]
+        items = []
+        for p in page:
+            name = library_service.get_relative_path(p)
+            items.append({
+                'name': name,
+                'media_url': f'/media/{quote(name, safe="/")}',
+                'thumb_url': f'/thumb?uri={quote(name, safe="")}',
+                'title': p.stem,
+                'duration': None,
+                'is_favorite': name in favorites,
+            })
+        return {'success': True, 'data': {
+            'items': items,
+            'total': total,
+            'has_more': offset + limit < total,
+        }}
+
     @app.route('/api/feed/mix')
     def api_feed_mix():
         page = _read_int_arg('page', 1, minimum=1)

tiklocal/services/__init__.py

@@ -8,6 +8,7 @@
 
 VIDEO_EXTENSIONS = {'.mp4', '.webm', '.mov', '.mkv', '.avi', '.m4v'}
 IMAGE_EXTENSIONS = {'.jpg', '.jpeg', '.png', '.gif', '.webp', '.bmp'}
+AUDIO_EXTENSIONS = {'.mp3', '.flac', '.aac', '.m4a', '.ogg', '.opus', '.wav'}
 FAVORITE_FILENAME = 'favorite.json'
 
 class LibraryService:
@@ -45,6 +46,17 @@ def scan_videos(self, recursive=True) -> list[Path]:
         except Exception:
             return []
 
+    def scan_audios(self, recursive=True) -> list[Path]:
+        """Scan for audio files."""
+        pattern = '**/*' if recursive else '*'
+        audios = []
+        try:
+            for ext in AUDIO_EXTENSIONS:
+                audios.extend(self.media_root.glob(f"{pattern}{ext}"))
+            return sorted(audios, key=lambda p: p.stat().st_mtime, reverse=True)
+        except Exception:
+            return []
+
     def scan_images(self, recursive=True) -> list[Path]:
         """Scan for image files."""
         pattern = '**/*' if recursive else '*'

tiklocal/services/thumbnail.py

@@ -6,6 +6,8 @@
 from pathlib import Path
 from tiklocal.paths import get_thumbnails_dir, get_thumbs_map_path
 
+AUDIO_EXTENSIONS = {'.mp3', '.flac', '.aac', '.m4a', '.ogg', '.opus', '.wav'}
+
 class ThumbnailService:
     def __init__(self, media_root: Path):
         self.media_root = media_root
@@ -36,8 +38,21 @@ def get_thumbnail(self, rel_path: str) -> tuple[Path | bytes, str]:
         return self.placeholder, 'image/png'
 
     def _generate(self, video_path: Path, output_path: Path, timestamp: float = None) -> bool:
+        suffix = video_path.suffix.lower()
+
+        # Audio: extract embedded cover art
+        if suffix in AUDIO_EXTENSIONS:
+            cmd = ['ffmpeg', '-i', str(video_path), '-an', '-vframes', '1', str(output_path), '-y']
+            try:
+                sp.run(cmd, stdout=sp.DEVNULL, stderr=sp.DEVNULL, timeout=30)
+                if output_path.exists() and output_path.stat().st_size > 0:
+                    return True
+            except Exception:
+                pass
+            return False
+
         candidates = [timestamp] if timestamp is not None else [5.0, 1.0, 0.1]
-        
+
         for t in candidates:
             cmd = [
                 'ffmpeg', '-y',

tiklocal/static/input.css

@@ -61,6 +61,29 @@ video, img, canvas, svg {
   @apply bg-gray-400 dark:bg-gray-500;
 }
 
+/* Radio 波形动画 */
+@keyframes wave-bar {
+  0%, 100% { transform: scaleY(0.3); }
+  50%       { transform: scaleY(1); }
+}
+.audio-waveform {
+  display: flex;
+  gap: 4px;
+  align-items: center;
+  justify-content: center;
+}
+.audio-waveform span {
+  width: 5px;
+  border-radius: 3px;
+  background: currentColor;
+  animation: wave-bar 1s ease-in-out infinite;
+}
+.audio-waveform span:nth-child(2) { animation-delay: 0.1s; }
+.audio-waveform span:nth-child(3) { animation-delay: 0.2s; }
+.audio-waveform span:nth-child(4) { animation-delay: 0.3s; }
+.audio-waveform span:nth-child(5) { animation-delay: 0.4s; }
+.audio-waveform.paused span { animation-play-state: paused; }
+
 /* 焦点环优化 */
 .focus-ring {
   @apply focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 dark:focus:ring-offset-gray-800;