🎵 Sky Auto Player

Auto-plays Sky music sheets on Windows, in time.

🌐 Landing page · FAQ · Download

---

Sky Auto Player turns song sheets from the specy/skyMusic editor into clean chords, fast arpeggios, and long holds played in-game, automatically. It sends standard keystrokes through the public Windows SendInput API — the same channel any keyboard macro uses — and never reads game memory, injects code, hooks the process, attaches a debugger, or touches game files.

Warning

Automated music playback may violate Thatgamecompany's Terms of Service. Use this tool responsibly and at your own risk.

---

Quick start

Requirements: Windows 10 or 11 (64-bit). The packaged build ships its own Python — no system Python, no installer, no admin rights, no registry entries.

1. Download Sky-Auto-Player-v<latest>.zip from the latest release.
2. Extract it anywhere — e.g. C:\Sky-Auto-Player\.
3. Run Sky-Auto-Player.exe.

Add a song

1. Open the Sky Music Nightly editor.
2. Export a song as JSON, skysheet, or JSON-compatible txt.
3. Drop the file into the songs/ folder next to Sky-Auto-Player.exe.
4. Press Ctrl+R in the picker to reload.

---

Features

• Textual TUI picker — fuzzy search by song name, fully keyboard-driven
• Per-song profiles — timing, tempo, FPS, theme
• Dry-run mode — preview without sending input
• Live HUD — timing jitter and dispatch health at a glance
• Tuning presets — for weak PCs, the free-threaded python3.14t interpreter, and more
• Hotkeys — / command palette · F8 pause · F9 skip · F10 stop · q / Esc quit

---

Updating

Sky Auto Player checks GitHub for new releases and shows a banner when one is available. It never self-updates while running — applying an update is one explicit step:

1. Close Sky Auto Player.
2. Run updater.bat in the install folder.
3. Reopen Sky-Auto-Player.exe.

Note

Pre-2.4.2 Migration: If your installation is named Sky-Player (v2.4.1 or earlier), simply run your existing updater.bat once. It will automatically download the legacy bridge update, migrating you to the new Sky-Auto-Player.exe and the new updater scripts.

The updater verifies SHA256 before touching any file, rolls back failed copies transactionally, and never replaces your config.json or songs/ folder. Pre-release builds: updater.bat -Channel beta.

---

FAQ

Will this get me banned?

It sends only standard keyboard input and never touches the game — no memory reads, no hooks, no code injection, no file modification. That is the same channel any keyboard macro uses. Automated playback may still conflict with Sky's Terms of Service, however, so use it responsibly and at your own risk.

Does it run on macOS or Linux?

No. Sky Auto Player depends on Windows-specific APIs — SendInput for input simulation and MMCSS for real-time thread scheduling. macOS and Linux are not on the roadmap.

Can I build it from source?

Yes. Clone the repo, run uv sync to set up the Python 3.14 free-threaded environment, then launch with uv run python src/main.py. Run --doctor to verify your GIL state, MMCSS availability, and key mapping, and see docs/tuning-presets.md for non-standard environment presets.

The full FAQ — 14 questions covering file formats, troubleshooting, the update mechanism, and the security model — lives at https://pumni.github.io/Sky-Auto-Player/faq/.

---

Support

If Sky Auto Player has saved your wrist, leave a star — it helps other players find the tool. Bug reports and ideas go to GitHub Issues. To support development directly:

---

License

GNU General Public License v3.0 · © pumni