{"id":23619275,"url":"https://github.com/jkulvich/cotltracker","last_synced_at":"2025-08-08T21:22:58.101Z","repository":{"id":52081603,"uuid":"254770859","full_name":"jkulvich/COTLTracker","owner":"jkulvich","description":"🎮 \"Sky: Children of the Light\" Android ADB music assistant","archived":false,"fork":false,"pushed_at":"2023-07-10T13:50:28.000Z","size":40750,"stargazers_count":28,"open_issues_count":8,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-01T06:51:17.398Z","etag":null,"topics":["adb","android","assistant","cheat","children-of-the-light","command-line","command-line-tool","game","go","golang","musical-instruments","tones","tool","tracker"],"latest_commit_sha":null,"homepage":"https://github.com/jkulvich/cotltracker","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jkulvich.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-04-11T01:35:18.000Z","updated_at":"2025-01-20T06:26:43.000Z","dependencies_parsed_at":"2023-10-21T01:15:19.327Z","dependency_job_id":null,"html_url":"https://github.com/jkulvich/COTLTracker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jkulvich/COTLTracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkulvich%2FCOTLTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkulvich%2FCOTLTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkulvich%2FCOTLTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkulvich%2FCOTLTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jkulvich","download_url":"https://codeload.github.com/jkulvich/COTLTracker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkulvich%2FCOTLTracker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259293098,"owners_count":22835539,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adb","android","assistant","cheat","children-of-the-light","command-line","command-line-tool","game","go","golang","musical-instruments","tones","tool","tracker"],"created_at":"2024-12-27T19:48:38.526Z","updated_at":"2025-10-14T12:06:28.344Z","avatar_url":"https://github.com/jkulvich.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![GitHub](https://img.shields.io/github/license/jkulvich/cotltracker)](https://github.com/jkulvich/COTLTracker/blob/master/LICENSE)\n![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/jkulvich/cotltracker)\n[![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/jkulvich/cotltracker)](https://github.com/jkulvich/COTLTracker/releases)\n[![GitHub issues](https://img.shields.io/github/issues/jkulvich/cotltracker)](https://github.com/jkulvich/COTLTracker/issues)\n[![GitHub last commit](https://img.shields.io/github/last-commit/jkulvich/cotltracker)](https://github.com/jkulvich/COTLTracker/commits/master)\n\n\u003e **Note**\n\u003e \n\u003e Dear users, thank you for your stars and contributions. It's really so important for me. This project was one of first which goal automate musical instrument playing for Sky: Children of The Lights. After time, we have several better alternatives (see links). And I have no time to maintain this tool anymore. It's sad, but this tool isn't actual anymore.\n\u003e\n\u003e Thank you all for your support!  \n\u003e You all are breathtaking ;)\n\u003e \n\u003e Special thanks to [@MapleStudio](https://www.youtube.com/@MapleStudio) for my inspiration and great tool to learn and play COTL instruments [SkyStudio](https://play.google.com/store/apps/details?id=com.Maple.SkyStudio)\n\n\u003e **Warning**\n\u003e \n\u003e - Stable work guaranteed only if you **play on Android** and you **have a Linux (Ubuntu based) device**\n\u003e - For **Windows** users it's possible to **run Linux inside virtual machine** (like Virtual Box)\n\u003e - For **Windows** users it's not possible to run this tool under CMD, PowerShell or WSL (due WSL USB restrictions)\n\u003e - At the moment, this project **have not active maintenance**, use similar tools like:\n\u003e     - [Sky Auto Music: Clicker Studio](https://play.google.com/store/apps/details?id=com.zhukovartemvl.skyautomusic)\n\u003e     - [Sky Music Studio: Auto](https://play.google.com/store/apps/details?id=com.edegrangames.skyMusic)\n\n# :joystick::notes: COTLTracker :: Players' assistant\n\"Sky: Children of The Light\" musical assistant tool to automatic play on in-game musical instruments\n\n![Tool Proof](./assets/proof2.gif)\n\n:eyes: YouTube Demos:\n1. [Love Scenario | Piano](https://youtu.be/ejYJq7mixME)\n2. [Girls Like You | Piano](https://youtu.be/8W7AQtnZh0k)\n3. [Counting Stars | Piano](https://youtu.be/JMDFZYuwwz8)\n4. [Way Back Home | Piano](https://youtu.be/OMZEtMOoTOI)\n5. [River Flows in You | Horn](https://www.youtube.com/watch?v=-RD3mvBv8M8) - :-1: Bad Record\n6. [Sparkle | Piano](https://www.youtube.com/watch?v=9vW_sGyi8EE) - :-1: Bad Record\n7. [Zen Zen Zense | Piano](https://www.youtube.com/watch?v=WTTuqxaN5xg) - :-1: Bad \n\nMy source of inspiration for music is [Maple on YouTube](https://www.youtube.com/channel/UCDckPUJKSo9UeVtlY31p3Ag)\n\n# :v: Contact info\nFor legal issues, tech questions and chatting.  \nPlease, feel free to text me anytime :)\n\n- [Telegram | @jkulvich](https://t.me/jkulvich) - :star: Priority\n- [Instagram | @ijkulvich](https://instagram.com/ijkulvich)\n- [Twitter | @jkulvich](https://twitter.com/jkulvich)\n- [VKontakte | @jkulvich](https://vk.com/jkulvich)\n- [EMail | jkulvichi@gmail.com](mailto:jkulvichi@gmail.com)\n\n# :fast_forward: Fast Start To Play\n\n## :iphone::left_right_arrow::computer: Prepare it\nPlease, prepare your android phone and plug it with your PC.  \n**IMPORTANT**: Using of the tool suitable only for android players.\n1. [**Enable USB debugging**](https://www.phonearena.com/news/How-to-enable-USB-debugging-on-Android_id53909) on your phone, It is in developer options.\n2. [**Install ADB**](https://www.xda-developers.com/install-adb-windows-macos-linux/) on your PC.\n    1. If you are a Windows user, make sure that [**ADB is in %PATH% variable**](https://nerdschalk.com/set-adb-fastboot-path-windows)\n3. **Plug your phone** with your PC and accept debug permissions if required.\n\n## :package::arrow_down: Configure it\nSee latest release with [prebuilds and tracks here](https://github.com/jkulvich/COTLTracker/releases).\n1. **Download** one of these **prebuilt binary** app for your PC OS.\n2. **Download an archive** with musical tracks for player and unpack it near the app.\n\n\u003e Installation folder does not matter. You can drop prebuilt binary and tracks folder in any folder.\n\n## :computer::arrow_forward: Run it\n1. **Run a terminal** on your PC. If you're a Windows user, just press RMB when Shift pressed and select \"Open command window here\" or \"Open PowerShell here\". You _should be in same directory_ where the app located.\n2. **Execute next command**: `player --test` when the game running on your phone. _Don't forget take a musical instrument in your hands!_\n3. **Run a lovely track**: When the short test passed type: `player --track tracks/sparkle.txt` and press Enter.\n\nYou can stop the app by CTRL+C.\n\n## :musical_note: Prepared tracker files\n\nYou can find it in the [tracks folder](./tracks)\n\n# :checkered_flag: Flags\n\n- track - Path to track file (musical file)\n- delay - Delay in ms between taps (default is 80, increment it if your device can't catch all tones)\n- start - Number of block where to start (default is 0)\n- test - Run taps test for all musical instrument buttons (Check it before real usage)\n\nSimple example:\n```bash\n./player --track ./tracks/zen_zen_zense.txt\n```\n\n# :1234: Block in tracker file\n\nThere are 3 blocks' types:\n- **Delay** - several presentation types are available:\n    - **Number** - milliseconds: `200 500` - :-1: Deprecated\n    - **tN** - 200ms * N: `t t5 t10` - :-1: Deprecated\n    - **Dash** - 200ms * dash_count: `- -- ---` - :star: Modern Variant\n- **Note** - note in char notation like: `C4 A2 G5`\n- **Chord** - chord like: `Am E G` (Not all notes available, use **Note** instead) - :-1: Deprecated\n\nPlease, use dash or t for timings, so you can change\nthe track speed by changing the `timing` comment.\n\n```\n#!TIMING:200\n#!SHIFT:2\n```\n\n# :arrow_up_small::arrow_down_small: Tones transposing\n\nThe tool has an auto transpose mechanism.\nSo, if you are using `A4 B5 C4` then all notes for 4 octaves will be\ntransposed to 1 octave\n```\n[C4] [  ] [  ] [  ] [  ]\n[A4] [  ] {  } {  } {  }\n{  } {  } {  } {B5} (  )\n```\n\nIf you want to use only second octave then make a `shift` comment\nwith value `7`. So, you'll shift all notes for 7 tones.\n\nFor example, without the comment `A4` position will look like:\n```\n[  ] [  ] [  ] [  ] [  ]\n[A4] [  ] {  } {  } {  }\n{  } {  } {  } {  } (  )\n```\nWith the comment:\n```\n[  ] [  ] [  ] [  ] [  ]\n[  ] [  ] {  } {  } {  }\n{  } {  } {A4} {  } (  )\n```\n\n# :information_source: Game notes\n\n```\n[C1] [D1] [E1] [F1] [G1]\n[A1] [B1] {C2} {D2} {E2}\n{F2} {G2} {A2} {B2} (C3)\n```\n\n```\nC1   D1   E1   F1   G1   A1   B1   C2   D2   E2   F2   G2   A2   B2   C3\n``` \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjkulvich%2Fcotltracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjkulvich%2Fcotltracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjkulvich%2Fcotltracker/lists"}