Skip to content

Uberration/TheViewer

Repository files navigation

Musik Archive Viewer

License Python Version

A comprehensive, modular, and high-performance desktop application for scanning, organizing, and playing your media generated by Udio.

Preview Windows Portable Build: MusikArchiveViewer v.01


image

🌟 Features

  • Advanced Media Scanning: Recursively scan directories to discover and group Udio tracks with their associated metadata, lyrics, and artwork files.
  • High-Performance UI: Features a fully virtualized track list capable of smoothly displaying thousands of items without performance degradation.
  • Audio Playback: Professional-grade audio player supporting multiple backends (VLC, Pygame), full playback controls (play, pause, seek), and playlist management (repeat, shuffle).
  • Dynamic Theming: Instantly switch between light and dark modes. -Needs implementing with UI-
  • Detailed Metadata View: A tabbed interface to explore all track metadata, including core info, prompts, lyrics, technical details, and raw JSON data.
  • Asynchronous Image Loading: Non-blocking artwork and thumbnail loading with an LRU cache to keep the UI responsive at all times. - CURRENTLY BROKEN
  • Modular Architecture: Built with a clean separation of concerns (Domain, Services, UI, Utils) for excellent maintainability and extensibility.

HOW TO USE:

Use the UdioArchiver.js script with Tampermonkey on your favorite browser (Tested with Chrome and Firefox) When you have your export, scan the directory they were saved in with this tool.

Got another format you want to import like json or something else? Give a shout and maybe it will be implemented!

REQUIREMENTS:

Image processing for UI Pillow>=9.0.0

Audio playback pygame>=2.1.0

Audio metadata parsing mutagen>=1.45.0

File locking utility for safe concurrent access filelock>=3.12.0

Clipboard access pyperclip>=1.8.2

📊 Project Statistics

  • Total Python Files: 59
  • Total Lines of Code: 13,718
  • (Statistics generated on: 2025-11-12)

About

Viewer for exported music and metadata

Resources

License

Stars

Watchers

Forks

Packages

No packages published