{"id":26296045,"url":"https://github.com/mo42/inven","last_synced_at":"2025-05-09T00:50:53.935Z","repository":{"id":192460158,"uuid":"686643694","full_name":"mo42/inven","owner":"mo42","description":"Keep an inventory of your physical belongings 📦📜","archived":false,"fork":false,"pushed_at":"2025-02-16T11:28:23.000Z","size":1355,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T01:52:52.555Z","etag":null,"topics":["command-line-tool","inventory-management","minimalism","productivity"],"latest_commit_sha":null,"homepage":"","language":"Haskell","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/mo42.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-03T13:32:13.000Z","updated_at":"2025-02-16T11:28:27.000Z","dependencies_parsed_at":"2023-09-22T01:48:57.751Z","dependency_job_id":"a00d2223-eadd-4d35-9d1c-c951c3e842a6","html_url":"https://github.com/mo42/inven","commit_stats":null,"previous_names":["mo42/inven"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo42%2Finven","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo42%2Finven/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo42%2Finven/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo42%2Finven/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mo42","download_url":"https://codeload.github.com/mo42/inven/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253171218,"owners_count":21865282,"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":["command-line-tool","inventory-management","minimalism","productivity"],"created_at":"2025-03-15T04:16:45.980Z","updated_at":"2025-05-09T00:50:53.911Z","avatar_url":"https://github.com/mo42.png","language":"Haskell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# inven\nKeep track of all your stuff. Manage your physical belongings with `inven` 📦📜\n\nExample view in browser when running `inven serve`:\n![Example Inventory in Browser](example.png)\n\n## Installation\n\nBuild and installation requirements:\n- GHC\n- Stack\n\n```sh\ngit clone https://github.com/mo42/inven.git \u0026\u0026 cd inven\nstack install\n```\n\nIf you have `.local/bin` in your PATH environment variable, you should be able\nto run the `inven` command.\n\n### Docker\n\nYou can create a Docker image by running `docker build -t inven-app`.\n\nTo have a persistent state, I use the volume option to mount the directory from the host:\n```sh\ndocker run\n    -p 4200:4200 \\\n    -v ~/.local/share/inven:/home/invenuser/.local/share/inven:rw,Z \\\n    inven-app\n```\n\n## Usage\n\n```\n$ inven --help\nUsage: inven COMMAND\n\nAvailable options:\n  -h,--help                Show this help text\n\nAvailable commands:\n  add                      Add an item\n  find                     Find item by reg. exp.\n  remove                   Remove an item\n  value                    Sum of all values\n  count                    Number of items\n  edit                     Edit item in editor manually\n  consume                  Consume item (ie, decrement quantity)\n  prune                    Clear items from database where quantity is zero\n  show                     Show item\n  expired                  List expired items\n  list                     List all items\n  serve                    Start web server for browsing inventory\n```\n\n\n### Add item to your inventory\n\n#### Examples\n```sh\ninven add --text=\"Some item description\"\ninven add --text=\"Some item description\" --value=42.42 --date=2023-07-01\n```\n\n#### Required and optional parameters or attributes\n```sh\n$ inven add\nMissing: --text description\n\nUsage: inven add --text description [--date date] [--quantity quantity]\n                 [--value value] [--price price] [--category category]\n                 [--container container] [--location location] [--expiry expiry]\n                 [--photo photo]\n\n  Add item\n```\n\n\n### Remove or consume item from inventory by ID\nConsume means that used up one piece (i.e., the quantity is decremented).\nRemove means that the entire record is deleted.\n```sh\ninven consume 42\ninven remove 43\n```\n\n### Search Inventory Database\n```\n$ inven find --regex=\"music\"\nID Category                    Description  Purchased Value Price Quantity\n01 music                       Yamaha CP50 2015-10-01 450.0  none        1\n02 music    Bach The Well-Tempered Clavier 2019-04-02  none  20.0        1\n```\n\n# License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmo42%2Finven","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmo42%2Finven","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmo42%2Finven/lists"}