andresgarcia0313
/
AppleVLC
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Modern VLC Media Player skin inspired by Apple Human Interface Guidelines
5 Commits 1 Branch 0 Tags 925 KiB
Python 100%
Go to file
Andrés Eduardo García Márquez 63e7e645dd docs: Add project documentation 
- README.md: Project overview, features, installation guide
- DEVELOPMENT.md: Lessons learned, common errors to avoid,
  VLC Skins2 reference, and development checklist
- CLAUDE.md: Project-specific Claude Code instructions

Key documented issues:
- Invalid XML attributes (action on Video, var on Playtree)
- Non-existent actions (dialogs.equalizer, vlc.setLoop)
- Shadow rendering problems in VLC Skins2
- Margin calculations for element positioning

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 		2026-01-11 19:49:36 -05:00
fonts feat: Add VLC skin core files 2026-01-11 19:49:10 -05:00
images feat: Add generated PNG assets 2026-01-11 19:49:19 -05:00
.gitignore chore: Add .gitignore 2026-01-11 19:48:58 -05:00
AppleVLC.vlt build: Add packaged VLC skin 2026-01-11 19:49:26 -05:00
CLAUDE.md docs: Add project documentation 2026-01-11 19:49:36 -05:00
DEVELOPMENT.md docs: Add project documentation 2026-01-11 19:49:36 -05:00
README.md docs: Add project documentation 2026-01-11 19:49:36 -05:00
generate_assets_v3.py feat: Add VLC skin core files 2026-01-11 19:49:10 -05:00
theme.xml feat: Add VLC skin core files 2026-01-11 19:49:10 -05:00

README.md

AppleVLC - VLC Media Player Skin

Skin moderna para VLC Media Player inspirada en Apple Human Interface Guidelines.

Características

  • Diseño limpio: Fondo con esquinas redondeadas (superelipse/squircle) estilo Apple
  • Controles intuitivos: Botones de 44px siguiendo las guías de Apple para touch targets
  • Información completa: Título, tiempo, bitrate y sample rate visibles
  • Controles de ventana: Solo cerrar y minimizar (sin maximizar, al estilo macOS)
  • Estados visuales: Hover con tinte azul Apple (#007AFF), estados disabled
  • Iconos secundarios: Color gris sistema (#8E8E93) para jerarquía visual

Controles Disponibles

Fila Principal

  • Stop, Playlist, Shuffle, Previous, Play/Pause, Next, Repeat All, Repeat One, Fullscreen

Fila Inferior

  • Volume (con slider), Equalizer, A-B Loop, Speed

Ventanas Adicionales

  • Video Window (640x480, redimensionable)
  • Playlist Window (320x400)
  • Fullscreen Controller

Instalación

  1. Copiar AppleVLC.vlt a ~/.local/share/vlc/skins2/
  2. En VLC: Herramientas → Preferencias → Interfaz → Usar skin personalizado
  3. Seleccionar AppleVLC.vlt
  4. Reiniciar VLC

O ejecutar directamente:

vlc -I skins2 --skins2-last /ruta/a/AppleVLC.vlt

Estructura del Proyecto

PielVLC/
├── AppleVLC.vlt          # Skin empaquetada (ZIP)
├── theme.xml             # Definición de la interfaz
├── generate_assets_v3.py # Script para generar PNGs
├── images/               # Assets PNG generados
├── fonts/                # Fuentes Liberation Sans
└── DEVELOPMENT.md        # Guía de desarrollo

Especificaciones Técnicas

  • Dimensiones: 500x225 px (ventana principal)
  • Márgenes: 20-30px en todos los bordes
  • Track slider: 8px de altura, 440px de ancho
  • Volume slider: 6px de altura, 80px de ancho
  • Colores:
    • Fondo: #F5F5F7 (Apple Light Gray)
    • Texto primario: #000000
    • Texto secundario: #3C3C43
    • Iconos secundarios: #8E8E93
    • Acento: #007AFF (Apple Blue)
    • Borde sutil: rgba(0,0,0,0.08)

Regenerar Assets

python3 generate_assets_v3.py
zip -r AppleVLC.vlt theme.xml images/ fonts/

Requisitos

  • VLC 3.0+ con soporte skins2
  • Python 3 + Pillow (solo para regenerar assets)

Autor

Claude Code - Anthropic

Licencia

MIT License