{"id":26796254,"url":"https://github.com/nicholaswagner/pico-tools","last_synced_at":"2025-04-22T19:57:32.793Z","repository":{"id":57152822,"uuid":"132147066","full_name":"nicholaswagner/pico-tools","owner":"nicholaswagner","description":"A command line interface for pico-8","archived":false,"fork":false,"pushed_at":"2020-04-07T21:51:04.000Z","size":60,"stargazers_count":14,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-29T18:17:53.795Z","etag":null,"topics":["cli","pico-8"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/nicholaswagner.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}},"created_at":"2018-05-04T13:58:18.000Z","updated_at":"2023-04-08T11:48:16.000Z","dependencies_parsed_at":"2022-09-06T20:50:55.269Z","dependency_job_id":null,"html_url":"https://github.com/nicholaswagner/pico-tools","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/nicholaswagner%2Fpico-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicholaswagner%2Fpico-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicholaswagner%2Fpico-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicholaswagner%2Fpico-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicholaswagner","download_url":"https://codeload.github.com/nicholaswagner/pico-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250315855,"owners_count":21410473,"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":["cli","pico-8"],"created_at":"2025-03-29T18:17:58.296Z","updated_at":"2025-04-22T19:57:32.769Z","avatar_url":"https://github.com/nicholaswagner.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pico-tools\n\u003e Fast and simple.  Just like me.  - the author\n\nDon't make me take my hands off the home row!\nThis is a toolchain I use to make pico-8 dev a little faster and more flexible.\n\n`setup` lets you configure the current folder for pico-tools.(you can have different settings per folder)\n`build` will load your cart in pico-8, and auto-play automatically.\n`watch` will detect changes to your .p8 file and run another `build`.\n`add_vscode_tasks` will copy over a .vscode/tasks.json file which let you do the same, but from a hotkey.\n\n## PreReqs\n1. An installed copy of [pico-8](https://www.lexaloffle.com/)\n2. requires [nodejs and npm](http://www.nodejs.org)\n\n## Gimme Gimme!\nYeah, yeah, calm down.\n```bash\n# install pico-tools with \nnpm install -g pico-tools\n```\n\n## Setup is a piece of cake\npico-tools uses an environment variable to know where your pico-8 executable is.\n\nThere are many ways to do that, but we've included an easy way for beginners:\n\nSimply create a `.env` file at the root of your project folder with one of the following: ( Your setup may differ slightly. )\n\n```bash\n# Typical Windows setup\nPICO8=c:\\Users\\nicho\\Desktop\\pico-8_win32\\pico8.exe\n\n# Typical MacOS setup\nPICO8 = /Applications/PICO-8/PICO-8.app/Contents/MacOS/pico8\n```\n\n\n## Documentation\n\n---\n\n### `pico-tools build`\n\n```bash\n# run a cartridge in pico-8 and have it auto-play.\n\npico-tools build path/to/cartridge.p8\n```\n\n---\n\n### `pico-tools watch`\n\n```bash\n# watch a specific file for changes, and then reload automatically.\n\npico-tools watch path/to/cartridge.p8\n```\n\n***WARNING***  If you use the watch command, please note that when the tools trigger a reload, you will lose any unsaved changes in the pico editor.  This goes for sprites and music too!  Keep that in mind so you don't lose work!\n\n---\n\n### `pico-tools vscode_tasks`\n```bash\n# This will create `.vscode/tasks.json` in your current directory.  This lets me hit `cntrl+shift+b` and activate one of the tools.\n\npico-tools vscode_tasks\n```\n\n---\n\n### `pico-tools home`\n\n```bash\n# will open the pico-tools github page\n\npico-tools home\n```\n\n---\n\n### `pico-tools bbs`\n\n```bash\n# will open the pico-8 bbs in your browser\n\npico-tools bbs\n```\n\n---\n\n### `pico-tools man`\n\n```bash\n# This will echo the Pico-8 Documentation to the terminal.\n# Combine this with other tools like less or grep!\n# example:    pico-tools man | less\npico-tools man\n```\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicholaswagner%2Fpico-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicholaswagner%2Fpico-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicholaswagner%2Fpico-tools/lists"}