Install Lyra¶
Lyra installs three ways. The browser install needs nothing but the Zune and a Wi-Fi network. The
two USB paths need a PC and a deploy tool. All three put the platform in \flash2\automation and
reboot, and from then on the device loads Lyra at boot with no installer involved.
From the Zune's browser¶
You need a Zune HD on firmware 4.5, joined to a Wi-Fi network. There is nothing to download first and no PC involved.
- Open the browser and go to
install.zune.moe. - Tap Install.
- Wait. The device reboots on its own.
The page writes a small installer to \Flash2\lyraboot.exe and runs it. That installer fetches the
platform package, checks it against a digest compiled into itself, unpacks it into
\flash2\automation and reboots.
Nothing here is served over HTTPS. The Zune HD's browser cannot complete a handshake with a current server and carries no certificate authority that signs for the domain, so the page and the package both arrive over plain HTTP and the installer proves the package by SHA-256 instead. Mod downloads after the install use TLS, through the daemon's own stack.
If the page says the attempt did not take, tap Install again. Getting code running depends on
winning a race inside the browser's script engine, and losing it changes nothing on the device.
Adding ?debug=1 to the address shows what each attempt did.
The installer stays at \Flash2\lyraboot.exe afterwards, which makes a reinstall free. It never
runs on its own, and removing Lyra leaves it in place.
Running it again on a device that already has Lyra repairs or updates it. Your installed mods, their settings and your media are untouched. It installs whatever version the page offers without checking what is already there, so it will take a device running a newer build back to that version. If the page sits on Installing and the Zune never restarts, a previous run was still finishing: nothing was written, so wait a moment, reload and tap Install again.
From a PC over USB¶
Both USB paths carry the same payload and produce the same result, so pick the one matching the deploy tool you have.
| Form | File | Deploy with |
|---|---|---|
| Deploy Kit | lyra-hd-deploykit/ (a folder) |
zune-deploy over USB-MTP |
| XNA package | lyra-hd.ccgame |
the XNA Game Studio Connect / Visual Studio deploy path |
You need the Zune connected and enumerated over USB, a release package from the
GitHub release or
built from source, and for the Deploy Kit path the
zune-deploy tool with its ~/.mtpz-data
authentication file.
zune-deploy installs the Zune.v4.0.Beta runtime if it is absent, streams the payload to the
device and launches it. The .ccgame is a standard XNA game package carrying the same runtime
profile and file layout; the stock Zune desktop software does not deploy it, but the XNA deploy
path does.
The launched title shows an install splash with the current step beneath it, copies the payload
into \flash2\automation, then counts down and reboots. A connection failure such as
ErrorNoDevice means the Zune was not enumerated over USB when the deploy started.
Unlike the browser install, this one leaves an entry under "apps" on the home screen. After the install its tile
reads Uninstall Project Lyra, and launching it again removes Lyra.
Confirming it worked¶
Open the Mods tab and check that it loads. Trigger the playback HUD and look for a new
quick-toggle button in the bottom right, where installed mods place their toggles. On Wi-Fi, the
Lyra daemon answers on port 1337.
Removing Lyra¶
Open the Mods tab, select the Project Lyra row and choose remove. The removal is armed as a
marker and runs at the top of the next boot, before any Lyra process starts, so every file deletes
cleanly. Devices installed from USB can also relaunch the renamed tile on the home screen.