HORN BUTTON 1.18.3 — standalone Windows x64 edition
ShoshiBuilds · https://hornbutton.shoshibuilds.com

CESKY — instalace na novem pocitaci
1. Ve Windows 10/11 x64 rozbalte CELY ZIP do vlastni zapisovatelne slozky,
   napr. Dokumenty\HornButton. Nespoustejte aplikaci uvnitr ZIPu nebo Program Files.
   Je potrebny .NET Framework 4.8 (standardni soucast aktualnich Windows 10/11).
2. Pro USB mapovani nejprve zavrete Horn Button a spustte Download-Driver.cmd.
   Skript stahne puvodni Interception 1.0.1 primo od autora a overi SHA-256.
   Jen pripravi soubory. Sam NIC neinstaluje do Windows a nezachytava klavesnici.
   Pred pouzitim prectete licence ve vendor\Interception\Interception\licenses.
   Interception ma oddelene nekomercni/komercni podminky; Horn Button vam
   automaticky neudeluje komercni licenci k ovladaci.
3. Pripojte tlacitko, spustte HornButton.exe a v Setup zvolte Activate input
   driver. Tato vyslovna akce vyzada prava administratora a nainstaluje systemove
   filtry klavesnice/mysi. Teprve aplikace omezuje mapovani na rozpoznane LinTx
   tlacitko. Kdyz hlasi Reconnect USB button, jednou ho odpojte a pripojte.
   Nektere konfigurace Windows ovladac zablokuji nebo potrebuji restart.
   Na tomto balicku nebyla provedena instalace na cistem pocitaci ani fyzicky test.
4. Vyberte Fun / Horn pro lokalni zvuky nebo Work pro vlastni mapovani.
   Soucasti je 27 zaznamenanych CC0 WAV a 6 syntetickych zvuku aplikace.
   Cizi osobni archiv, ulozena mapovani a nastaveni soucasti NEJSOU.
5. Web/ASB: v Chrome otevrete chrome://extensions, zapnete Rezim pro vyvojare,
   kliknete Nacist rozbalene a vyberte browser-companion (obsahuje manifest.json).
   Horn Button musi bezet. Povolte cilovy web v doplnku, vyberte otevrenou kartu
   a v aplikaci nastavte jeji URL a pozadovanou zkratku. Podrobny navod je
   browser-companion\setup.html. Chrome Web Store instalace neni soucasti.
6. Lokalni Library: OPEN-LIBRARY.cmd (Python je uz uvnitr balicku).
   Pro import souboru/ZIP bank, strih, obnovu a Live Audio nejprve spustte
   Setup-Audio-Tools.cmd. Stahne FFmpeg 8.1.2 Essentials primo od Gyan a overi
   zverejneny SHA-256; nepotrebuje administratora. FFmpeg ma vlastni GPLv3 licenci.
   Pokud uz Library bezela, spustte CLOSE-LIBRARY.cmd a potom OPEN-LIBRARY.cmd.
   Online stahovani YouTube/zdroju v teto edici neni dostupne; importujte vlastni
   lokalni audio, k jehoz pouziti mate opravneni. ASB/Horn/Fun nevyzaduji FFmpeg.

ENGLISH — clean-computer setup
Extract the complete ZIP into a writable Windows 10/11 x64 folder. Requires
.NET Framework 4.8. Do not run inside the ZIP. Before opening HornButton.exe,
run Download-Driver.cmd if you need USB mapping. This fetches and verifies the
unmodified official Interception package; it does not install drivers. Review
the author's separate commercial/non-commercial terms first. Open the app,
connect the button and explicitly select Setup > Activate input driver. This
requests administrator permission and installs keyboard/mouse filter drivers
system-wide; the app scopes mapping to the recognized LinTx button. Reconnect
the button if requested. Windows may block the driver or require a restart.
This package has not been physically tested on a clean machine.

For website/ASB control load browser-companion as an unpacked extension at
chrome://extensions, keep the desktop app running, allow the target website,
select its tab and configure its URL/shortcut in the app. Full instructions:
browser-companion/setup.html. Local sounds need no Chrome extension.

For local Library launch OPEN-LIBRARY.cmd. Embedded Python is included. Run
Setup-Audio-Tools.cmd before local audio import, ZIP bank import, trimming,
restoration or Live Audio. It downloads hash-pinned FFmpeg 8.1.2 Essentials
directly from Gyan (GPLv3), retaining its license/readme. No admin is needed.
If Library was already running, run CLOSE-LIBRARY.cmd then OPEN-LIBRARY.cmd.
Closing a browser tab alone leaves the local server running.
Online source downloading is unavailable in
this edition. Import local files you are entitled to use.

DEVICE
The verified device on the original development PC identifies as LinTx USB
keyboard VID_8088 / PID_0015. Compatibility with other buttons is unverified.
Original product listing supplied from the user's order (not an endorsement,
stock/price guarantee or proof every variant is compatible):
https://www.aliexpress.com/item/1005007358494108.html

DATA / UNINSTALL
App settings: %LOCALAPPDATA%\HornButton. Library data and imported audio:
catalog\data and catalog\media beside the app; keep this folder for your data.
Chrome native messaging is registered for the current user when the app runs.
The app stays in the tray after closing its window; quit via the tray menu.
To remove the input driver use the app's explicit uninstall action or run the
official vendor installer /uninstall as administrator. Reboot if requested.
Remove the unpacked Chrome extension at chrome://extensions. Then delete the
application folder when you no longer need its local recordings. Driver removal
is separate from deleting this folder. No startup task is enabled by this ZIP.

Distribution checks use static files and isolated local server/API tests.
They do not prove physical USB capture, audible playback, Chrome acceptance,
Windows driver compatibility or fresh-PC installation. The exe is unsigned;
Windows may show an unknown-publisher/SmartScreen prompt. Downloading never
installs a driver automatically. See THIRD-PARTY-NOTICES.txt and release-manifest.json.
