{"id":23980752,"url":"https://github.com/squiddev-cc/artist","last_synced_at":"2025-07-11T14:11:17.145Z","repository":{"id":37334030,"uuid":"75980827","full_name":"SquidDev-CC/artist","owner":"SquidDev-CC","description":"A Rather Tremendous Item SysTem","archived":false,"fork":false,"pushed_at":"2025-01-10T15:12:45.000Z","size":262,"stargazers_count":46,"open_issues_count":7,"forks_count":12,"subscribers_count":5,"default_branch":"vnext","last_synced_at":"2025-03-27T18:22:24.274Z","etag":null,"topics":["computercraft","plethora"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SquidDev-CC.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,"roadmap":null,"authors":null}},"created_at":"2016-12-08T22:34:16.000Z","updated_at":"2025-03-23T14:59:54.000Z","dependencies_parsed_at":"2024-01-07T16:38:58.578Z","dependency_job_id":null,"html_url":"https://github.com/SquidDev-CC/artist","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SquidDev-CC%2Fartist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SquidDev-CC%2Fartist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SquidDev-CC%2Fartist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SquidDev-CC%2Fartist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SquidDev-CC","download_url":"https://codeload.github.com/SquidDev-CC/artist/tar.gz/refs/heads/vnext","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248822933,"owners_count":21167146,"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":["computercraft","plethora"],"created_at":"2025-01-07T10:18:30.439Z","updated_at":"2025-04-14T04:34:01.413Z","avatar_url":"https://github.com/SquidDev-CC.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A Rather Tremendous Item SysTem\nArtist is an inventory management system for CC: Tweaked (requires MC 1.16.x or later). One could think of it as a\nbudget AE network. It offers an easy way to store and extract items, but powered entirely through ComputerCraft.\n\nhttps://user-images.githubusercontent.com/4346137/159051788-2664b57e-b184-4e1d-b759-99e5c010d539.mp4\n\n## Features\n - Index an arbitrary number of inventories (chests, barrels, etc...), allowing for insertion and extraction from them.\n - Simple interface to view and request items.\n - Inventory operations run in parallel, allowing for near-instant scanning and transfer of items.\n - Furnace management support, able to automatically refuel furnaces and insert smelted items into the main system.\n - Automatically dispose of items when you've got too many.\n\n## Install\n - Place down a turtle and some chests, and connect them all together with wired modems and networking cable.\n - Run `wget run https://raw.githubusercontent.com/SquidDev-CC/artist/HEAD/installer.lua` on your computer to install artist.\n - Run `/artist.lua` to start it. You may want to call this from your `startup.lua` file!\n\n## Basic usage\n - Type to filter items. All text inputs use standard [readline] keybindings, so \u003ckbd\u003eCtrl+u\u003c/kbd\u003e can be used to clear\n   the filter. Items are searchable using display name, item id and enchantments.\n - You can scroll through the list with \u003ckbd\u003e↑\u003c/kbd\u003e/\u003ckbd\u003e↓\u003c/kbd\u003e/\u003ckbd\u003ePgUp\u003c/kbd\u003e/\u003ckbd\u003ePgDown\u003c/kbd\u003e.\n - Hold \u003ckbd\u003eTab\u003c/kbd\u003e to see additional information about an item, such as its durability or enchantments.\n - You can close Artist (or any dialog within Artist) by typing \u003ckbd\u003eCtrl+d\u003c/kbd\u003e.\n - To extract an item, press \u003ckbd\u003eEnter\u003c/kbd\u003e. This brings up the \"Extract\" dialog. Hit \u003ckbd\u003eEnter\u003c/kbd\u003e again to\n   extract 64 items, or specify a different amount. The input box supports arbitrary expressions (like `64 * 2 + 16`),\n   which can be useful when working with larger numbers.\n - To smelt an item, press \u003ckbd\u003eCtrl+Shift+f\u003c/kbd\u003e. Here you can specify the number of items to smelt (defaulting to 64\n   again) and the number of furnaces to use (defaults to all of them). This requires furnaces to be attached on the\n   wired network.\n\n## Configuration\nArtist writes a (documented) config option to `.artist.d/config.lua`, which can be used to change some of Artist's\nbehaviour.\n\nSome options you may want to adjust:\n\n - `turtle` → `auto_drop`: Auto-drop items from the turtle's inventory when requested from the interface.\n - `furnace` → `fuels`: A list of valid fuels for the furnace.\n - `dropoff` → `chests`: A list of \"dropoff\" chests. Items inserted into them are automatically transferred into the\n   main system.\n - `trashcan` → `items`: Discard items when you've got too many of them. This requires another turtle on the network\n   running the [extra/trashcan.lua](extra/trashcan.lua) script. This is a mapping of items to the max number to stock.\n\n   **Example:**\n    ```lua\n    items = {\n      [\"minecraft:cobblestone\"] = 20000,\n      [\"minecraft:cobbled_deepslate\"] = 20000,\n    }\n    ```\n\n## Extending\nArtist is intended to be somewhat extensible, and you can register your own custom modules (be aware that the API is not\nstable though!) See the `examples/display.lua` file for an example.\n\n## History\nArtist is a pretty old program at this point. It was [first written in 2016][forum post] and, to my knowledge, was the\nfirst \"inventory management\" program for CC. While the code has changed a lot, the core ideas and interface haven't.\n\nIt should be noted that this is not the only item system out there, nor is it necessarily the best. There's a couple of\nother item systems I'm aware of out there:\n\n - **[Turtlegistics]:** This was the first inventory system to become popular on [SwitchCraft]. I _believe_ it's the\n   first to use the turtle's inventory as a drop-off and pickup point (Artist used separate chests beforehand).\n - **[Milo] (see also [this forum post][milo forum]):** Milo is probably the most powerful inventory system out there,\n   with support for crafting and remote item transfer (using Plethora's introspection module).\n\n[forum post]: http://www.computercraft.info/forums2/index.php?/topic/27321-mc-189-1122-plethora/page__view__findpost__p__262475 \"Artist on the ComputerCraft forums\"\n[turtlegistics]: https://github.com/apemanzilla/turtlegistics \"Tutlegistics on GitHub\"\n[milo]: https://github.com/kepler155c/opus-apps/tree/develop-1.8/milo\n[milo forum]: http://www.computercraft.info/forums2/index.php?/topic/29761-milo-crafting-and-inventory-system/\n[switchcraft]: https://switchcraft.pw \"The SwitchCraft Minecraft server\"\n[readline]: https://en.wikipedia.org/wiki/GNU_Readline \"GNU Readline - Wikipedia\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquiddev-cc%2Fartist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquiddev-cc%2Fartist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquiddev-cc%2Fartist/lists"}