Skip to content

Heraldic Player

Latest

Choose a tag to compare

@Aspirstudios Aspirstudios released this 13 Oct 20:00
· 1 commit to main since this release
7dc7997

๐”ฅ๐”ข๐”ฏ๐”ž๐”ฉ๐”ก๐”ฆ๐”  ๐”ญ๐”ฉ๐”ž๐”ถ๐”ข๐”ฏ

Python
pygame
yt-dlp
VLC
License

A handcrafted, local-only YouTube player for the medieval soul.
Black-and-white heraldry, golden filigree, and zero telemetry.

๐“˜. ๐“ฃ๐“ฑ๐“ฎ ๐“–๐“ช๐“ฝ๐“ฎ๐“ผ ๐“ธ๐“ฏ ๐“ฝ๐“ฑ๐“ฎ ๐“’๐“ช๐“ผ๐“ฝ๐“ต๐“ฎ

When invoking the artifact, your eyes will not be offended by a cold, generic, soulless menu. Instead, you will behold a purely heraldic introduction: two solemn swords converging over the figure of a radiant sun, followed by a golden flash that finally reveals the name of the house: Heraldic Player. The sovereign also receives a random greeting drawn from the chronicles, as if a different herald came to the staircase to welcome him each morning:

  • โ€œPeace and good, my lord! May the chords guide your journey on this new day.โ€
  • โ€œThe troubadour tunes the strings of his lute for your delight.โ€
  • โ€œThe gates of the fortress open wide before your presence.โ€

๐“˜๐“˜. ๐“ฃ๐“ฑ๐“ฎ ๐“ข๐“ฎ๐“ช๐“ป๐“ฌ๐“ฑ, ๐“ข๐“ฑ๐“ช๐“ป๐“น ๐“ช๐“ผ ๐“ช ๐“ฃ๐“ธ๐“ต๐“ฎ๐“ญ๐“ธ ๐“‘๐“ต๐“ช๐“ญ๐“ฎ

The search engine of this artifact does not settle for a single strategy nor trusts its fate to the hazards of the network. It interrogates the great library through four perfectly ordered cascade paths, respecting the siteโ€™s royal rank and not a defective approximation:

  1. It makes a direct request to the results URL using the power of yt-dlp, carrying the sp parameter correctly encoded in its lines.
  2. It executes its own direct query to the entrails of InnerTube via urllib, remaining independent of any general extractor.
  3. It carries out a meticulous reading of the results page to decode the framework of ytInitialData.
  4. As a last resort in the face of adversity, it summons the ytsearchN spell of yt-dlp itself.

If the arts of yt-dlp were to falter or become outdated before changes in the outside kingdom, the artifact itself detects it promptly and updates itself via pip. If the storm were such that everything else failed, the artifact leaves an honest and transparent testimony in the search_error.log file. In these lands there is no witchcraft or black magic: what you behold is pure engineering armored in steel.


๐“˜๐“˜๐“˜. ๐“•๐“ฒ๐“ต๐“ฝ๐“ฎ๐“ป๐“ผ, ๐“‘๐“ช๐“ท๐“ท๐“ฎ๐“ป ๐“ธ๐“ฏ ๐“Ÿ๐“ต๐“ช๐”‚๐“ซ๐“ช๐“ฌ๐“ด ๐“ช๐“ท๐“ญ ๐“›๐“ฒ๐“ซ๐“ป๐“ช๐“ป๐”‚ ๐Ÿ‡จ๐Ÿ‡ฆ

Every melody that enters the domains of the castle is classified with strict judgment by the scribes: individual song, detailed video, or long-duration song (podcast), always judging according to its channel of origin, its exact duration, and the words of its title. On the left of the interface the playback queue unfolds, rising majestically like the banner that guides your musical march; on the right, the library zealously guards your favorite songs, the history of past days, saved lists, and recently listened tunes. Saved lists synchronize automatically the moment the gates of the artifact open, bearing their corresponding timestamp and the cover of the first song as a coat of arms.


๐“˜๐“ฅ. ๐“ฃ๐“ฑ๐“ฎ ๐“”๐“บ๐“พ๐“ช๐“ต๐“ฒ๐”ƒ๐“ฎ๐“ป ๐“ช๐“ท๐“ญ ๐“ฝ๐“ฑ๐“ฎ ๐“๐“ป๐“ฝ ๐“ธ๐“ฏ ๐“ฃ๐“ธ๐“ท๐“ฎ

Beneath the visual stamp of the song that resounds in the halls, a forty-band equalizer pulses with a life of its own, reading the audio live through the threads of ffmpeg and decomposing it in real time through the complex mathematics of numpy. We are not before a dead or decorative ornament; the equalizer breathes, vibrates, and dances in perfect consonance with the waves of the music.

The speed control allows you to adjust the pace from a slow and ceremonious step of x0.50 to a full gallop of x2.00, ordered directly to the mystic VLC without altering at all the pitch of the work. For its part, the pitch control grants you the power to raise or lower the melody by up to twelve exact semitones, processing the audio stream in the workshops of ffmpeg using the rubberband tool if it is available in your kingdom, or applying the clever trick of asetrate with atempo otherwise. Processed files are stored temporarily in a sunroom (cache) that is purged automatically as soon as the weight of the supplies exceeds 250 MB.


๐“ฅ. ๐“›๐“ธ๐“ฐ๐“ฒ๐“ผ๐“ฝ๐“ฒ๐“ฌ๐“ผ ๐“ธ๐“ฏ ๐“ข๐“พ๐“น๐“น๐“ต๐“ฒ๐“ฎ๐“ผ ๐“ช๐“ท๐“ญ ๐““๐“ธ๐”€๐“ท๐“ต๐“ธ๐“ช๐“ญ๐“ผ

Provisioning your personal coffers with the best works of the kingdom is as simple as pressing the O key for the song that is active, or the W key if you wish to capture the entire view of the current inventory. The files disembark safe and without mishaps in the systemโ€™s musical armory, converted to the universal MP3 format if ffmpeg is working in the workshops, or to M4A if tools are scarce. The artifact itself takes care of resolving the presence of ffmpeg by its own means, even if it finds itself in need of importing it from the distant warehouses of imageio-ffmpeg.

Download armory path:

~/Music/YTMUSIC_CMD

๐“ฅ๐“˜. ๐“ฃ๐“ฑ๐“ฎ ๐“œ๐“ช๐“ฒ๐“ท ๐“ข๐“ฌ๐“ป๐“ฎ๐“ฎ๐“ท: ๐“๐“ท ๐“๐“ท๐“ฒ๐“ถ๐“ช๐“ฝ๐“ฎ๐“ญ ๐“ข๐“ฝ๐“ช๐“ฒ๐“ท๐“ฎ๐“ญ-๐“–๐“ต๐“ช๐“ผ๐“ผ ๐“ฆ๐“ฒ๐“ท๐“ญ๐“ธ๐”€

The home mode is not an inert list nor a cold index of parchments. It is a fully animated Gothic stained-glass window with golden stars that twinkle and float slowly across the length and breadth of the screen. Over this beautiful structure unfolds the organization of your entire fief: your saved lists, the songs of the last hours, the tunes most listened to by your lordship, your indisputable favorites, and the suggestions that the bard offers you based on your history and tastes. The covers of the songs are loaded in parallel execution threads, ensuring that the interface never stops or freezes waiting for responses from external networks.


๐“ฅ๐“˜๐“˜. ๐“๐“ธ ๐“ฃ๐“ป๐“ฒ๐“ซ๐“พ๐“ฝ๐“ฎ๐“ผ, ๐“๐“ธ ๐“๐“ฌ๐“ฌ๐“ธ๐“พ๐“ท๐“ฝ๐“ผ, ๐“๐“ธ ๐“๐“ธ๐“ฒ๐“ผ๐“ฎ

In this territory there are no mandatory Google logins, nor the intricate OAuth protocols, nor foreign passwords (tokens) that compromise your sovereignty. The operating system user is the only lord, judge, and absolute sovereign of what happens. Everything is stored and protected within your own physical lands.

The artifact has the ability to install its own dependencies if it detects that any are missing in the workshops (yt-dlp, python-vlc, pygame, pillow, numpy, imageio-ffmpeg), restarting promptly after the first forging is completed. If the VLC environment is not found in the kingdom, the artifact will attempt to summon it immediately through the systemโ€™s official heralds (winget, brew, apt, dnf, or pacman), rigorously adapting to the laws and customs of the computer territory where it runs.


๐•ฟ๐–๐–Š ๐•ถ๐–“๐–Ž๐–Œ๐–๐–™โ€™๐–˜ ๐•พ๐–๐–”๐–—๐–™๐–ˆ๐–š๐–™๐–˜

๐•ถ๐–Š๐–ž ๐•ฎ๐–”๐–“๐–๐–š๐–—๐–Š๐–‰ ๐•ฌ๐–ˆ๐–™๐–Ž๐–”๐–“
Space Pause the melody or resume the active song.
N / P Advance swiftly to the next song or return to the previous one.
+ / - Raise or lower the volume of the musical elixir.
โ† / โ†’ Rewind or advance ten seconds in the time of the work.
[ / ] Decrease or increase the speed of the musical gallop.
, / . Lower or raise the pitch by one exact semitone.
S / R Toggle shuffle and repeat the song.
F Mark the work as favorite within your coffers.
G Save the current list in the profileโ€™s parchment.
Y Synchronize all saved lists throughout the kingdom.
I Return immediately home (the animated stained-glass window).
L Display before your eyes the great library.
/ Invoke the sharp search engine.
Q Close the artifact, disarm the workshops, and leave in peace.

image image