Sky Auto Player · Reference

Frequently asked questions

Setup, sheet formats, Windows support, technical boundaries and troubleshooting for the timing-first music player.

Questions and answers

Is Sky Auto Player free?

Yes. It is open source under GNU GPL v3.0 and the packaged release is available from GitHub Releases.

Will I get banned for using Sky Auto Player with Sky: Children of the Light?

Sky Auto Player runs as a separate application and sends input through the Windows SendInput API. It does not inspect game memory, inject code into the game process or modify game files. Those technical boundaries do not guarantee that automated playback is permitted. It may conflict with Sky’s Terms of Service, so use it responsibly and at your own risk.

What file formats does Sky Auto Player support?

The supported set is JSON, .skysheet and JSON-compatible TXT. These files contain the structured sheet data that Sky Auto Player reads. See the source extension list for the current implementation.

Which Windows versions does Sky Auto Player support?

The packaged application supports 64-bit Windows 10 and Windows 11. Windows 7 and Windows 8 are not supported.

Where can I download Sky Auto Player?

Download the latest packaged ZIP from the Sky Auto Player GitHub Releases page.

Does Sky Auto Player work on Mac or Linux?

No. The current packaged application depends on Windows-specific APIs and does not provide a Mac or Linux build. The supported package is for 64-bit Windows 10 and Windows 11.

What is the difference between JSON, skysheet, and TXT sheet files?

JSON is the canonical structured form. A .skysheet file is a JSON-based sheet with that extension, while a TXT sheet is a plain-text file containing a JSON-compatible structure.

How does Sky Auto Player update itself?

The running app only notifies you about a release. Close the app and run updater.bat to apply an update. The updater verifies the downloaded ZIP’s SHA256 sidecar before touching installed files, stages and validates the release, copies binaries transactionally with rollback, and preserves config.json, .env, songs/ and logs/.

Only the update notification fields in config.json may be patched after a successful binary update.

Why are some notes dropped during playback?

If other players hear missing notes, first compare local playback and network conditions. Packet loss or latency can affect what reaches the game server. A different network route may help in some cases; some users try Cloudflare WARP, but no third-party network tool is guaranteed to solve the problem.

Can I tune Sky Auto Player for a weak PC?

Yes. Run --doctor to inspect environment status, then use the documented tuning presets for the packaged or source environment.

Can I build Sky Auto Player from source?

Yes. Clone the repository, run uv sync, then launch with uv run python src/main.py. The repository documents the Python 3.14 free-threaded environment and doctor checks.

Does Sky Auto Player need admin rights?

The portable app does not require an installer or administrator access for normal use. To remove it, close the app and delete its folder after preserving any songs or configuration you want to keep. The external updater.bat may need write permission for its installation folder.

Where are Sky Auto Player’s logs and config stored?

config.json and songs/ live alongside Sky-Auto-Player.exe. The external updater writes its log under %LOCALAPPDATA%\Sky-Auto-Player\updater.log.

Is Sky Auto Player related to the Sky Music web editor?

They are separate projects by separate authors, but they form a useful workflow pair. specy/skyMusic is an editor for authoring and exporting sheets; Sky Auto Player is the Windows player.

Ready to try a sheet?

Download the latest release, then return to the picker when your song is ready.