{"id":20410169,"url":"https://github.com/pieking1215/ptcmod","last_synced_at":"2025-04-12T16:03:09.571Z","repository":{"id":37695053,"uuid":"449610477","full_name":"PieKing1215/ptcMod","owner":"PieKing1215","description":"Mod for pxtone Collage that adds some shiny features","archived":false,"fork":false,"pushed_at":"2024-08-14T08:10:01.000Z","size":240,"stargazers_count":9,"open_issues_count":15,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-26T10:21:33.699Z","etag":null,"topics":["mod","pxtone","pxtone-collage"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PieKing1215.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"PieKing1215","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2022-01-19T08:36:17.000Z","updated_at":"2024-08-23T06:08:15.000Z","dependencies_parsed_at":"2025-04-12T16:01:22.545Z","dependency_job_id":null,"html_url":"https://github.com/PieKing1215/ptcMod","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PieKing1215%2FptcMod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PieKing1215%2FptcMod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PieKing1215%2FptcMod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PieKing1215%2FptcMod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PieKing1215","download_url":"https://codeload.github.com/PieKing1215/ptcMod/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248593713,"owners_count":21130312,"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":["mod","pxtone","pxtone-collage"],"created_at":"2024-11-15T05:44:47.239Z","updated_at":"2025-04-12T16:03:09.537Z","avatar_url":"https://github.com/PieKing1215.png","language":"Rust","funding_links":["https://ko-fi.com/PieKing1215"],"categories":[],"sub_categories":[],"readme":"# ptcMod\nMod for [pxtone Collage](https://pxtone.org/downloads/) that adds some shiny features\n\n![](../media/sample.png?raw=true)\n\n## READ THIS FIRST\nThe program is **extremely** invasive to ptCollage.\u003cbr\u003e\nThis project makes extensive use of unsafe code (read: raw memory manipulation, raw function calls into memory, ASM injection).\u003cbr\u003e\nThere is a chance it could explode your ptCollage at any moment and it has not been tested extensively.\u003cbr\u003e\nI would recommend not actually using this while composing right now.\u003cbr\u003e\nIf you must, save often and make some backups - if it randomly segfaults or something your unsaved changes will be very lost.\n\nptcMod may be flagged by antiviruses as a side effect of how it works. The way ptcMod injects into ptCollage is similar to how some viruses hook other processes, and some antiviruses will detect this. Obviously I can say this repo (PieKing1215/ptcMod) and official builds do not actually contain malware, but if you want to be sure, look over the code and [build from source](https://github.com/PieKing1215/ptcMod/wiki/Building).\n\n## Support\nThe goal is to continuously support at least both ptCollage 0.9.2.5 and whatever the latest version is.\u003cbr\u003e\nCurrently 0.9.2.5 and 0.9.4.54 (-\u003e https://github.com/PieKing1215/ptcMod/issues/22) are fully supported.\n\n## Basic usage\nHave ptCollage.exe open and run the injector exe.\u003cbr\u003e\nA popup should appear on ptCollage saying it injected, and a new menu option \"PTC Mod\" should appear in the menu bar.\u003cbr\u003e\nYou can edit the mod's settings there, or click \"Uninject\" to close ptcMod.\u003cbr\u003e\n*(ptcMod does not modify the actual ptCollage exe file, so you can also just close and reopen it to get rid of the mod)*\n\n# Features\n### FPS Unlock\nIf enabled, removes the fps limiting present in ptc 0.9.2.5.\u003cbr\u003e\n(note: the fps counter only goes to 99 in vanilla ptc, but this mod also patches it so it can display 3 digits)\n\n### Scroll Hook\nEnables custom scrolling handling. Some other features require this, and will be grayed out if scroll hook is disabled.\u003cbr\u003e\nHaving this enabled means the window is redrawn each frame, which results in far more GPU usage.\n\n### Smooth Scroll\nIf enabled, the song is scrolled smoothly while playing instead of snapping to each measure.\u003cbr\u003e\nDisable the vanilla \"scroll\" button in the player window to stop flickering.\u003cbr\u003e\nRequires Scroll Hook.\n\n### Playhead\nIf enabled, draws a vertical line at the song's current position while playing.\u003cbr\u003e\nRequires Scroll Hook.\n\n### Colored Units\nEach unit can have a different color, instead of them all being orange.\u003cbr\u003e\nCurrently hardcoded but will become customizeable.\u003cbr\u003e\nCurrently only applies in unit view; will be extended to keyboard view at some point.\n\n### Volume Fade\nIf enabled, when the song is playing notes will have varying transparency based on their volume and velocity.\u003cbr\u003e\nCurrently only applies in unit view; will be extended to keyboard view at some point.\u003cbr\u003e\n**High performance impact.**\n\n### Note Pulse\nIf enabled, notes will pulse whiteish when they are played.\u003cbr\u003e\nCurrently only applies in unit view; will be extended to keyboard view at some point.\u003cbr\u003e\nRequires Scroll Hook.\n\u003cbr\u003e\u003cbr\u003e\n\n### Misc other things\nDrag and drop [pxtone web](https://www.ptweb.me/) URLs (\"Drop URLs\" option)\n\n# Planned Features\n(Also see [the Project page](https://github.com/users/PieKing1215/projects/2))\n\nPerformance improvements (custom note rendering is extremely unoptimized)\n\nMore scrolling options - like snap to beat, or only scroll when the playhead is close to the right of the screen.\n\nPlayhead timing adjustment (so you can compensate for latency)\n\nRemove/raise the project title editor character limit since it saves/loads longer names just fine.\n\nIncrease the number of buffer measures after the end of the song so you can scroll further.\n\nSmooth line/curve tool for volume panel.\n\nAuto backup tool that automatically backs up the opened song at certain intervals or something.\n\nTempo change tool - enter a list of tempo changes and it will reposition notes/events to match.\n\nVST support\n\nSoundfont support\n\nProbably some more I can't think of.\n\nFeel free to suggest more on the [issue tracker](https://github.com/PieKing1215/ptcMod/issues)!\n\n## Download\nFor \"stable\" releases (there are none right now), see [Releases](../../releases).\u003cbr\u003e\nFor dev builds: sign in to GitHub, go [here](https://github.com/PieKing1215/ptcMod/actions/workflows/rust.yml?query=branch%3Amaster+is%3Asuccess), click the latest one, scroll down to \"Artifacts\" and download it.\u003cbr\u003e\nOr download at https://nightly.link/PieKing1215/ptcMod/workflows/rust/master/ptcMod.zip\u003cbr\u003e\nUnzip and run ptc-mod.exe to run.\n\n## License\n\n[pxtone](https://pxtone.org/) © [STUDIO PIXEL](https://studiopixel.jp)\n\nThis project contains no code from the original ptCollage or pxtone tools.\n\nptcMod licensed under either of\n\n * Apache License, Version 2.0\n   ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n * MIT license\n   ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)\n\nat your option.\n\n## Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in the work by you, as defined in the Apache-2.0 license, shall be\ndual licensed as above, without any additional terms or conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpieking1215%2Fptcmod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpieking1215%2Fptcmod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpieking1215%2Fptcmod/lists"}