{"id":23257328,"url":"https://github.com/turiphro/barcode-shopping-list","last_synced_at":"2026-03-03T05:31:57.192Z","repository":{"id":53622498,"uuid":"282613880","full_name":"turiphro/barcode-shopping-list","owner":"turiphro","description":"A shopping list that can be operated with a barcode scanner","archived":false,"fork":false,"pushed_at":"2025-01-23T10:21:41.000Z","size":3739,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-23T11:27:13.423Z","etag":null,"topics":["albert-heijn","barcode","barcode-scanner","barcode-shopping","groceries","python","shopping-list"],"latest_commit_sha":null,"homepage":"https://turiphro.nl/projects/barcode-scanner-shopping-list","language":"Python","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/turiphro.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-26T09:05:44.000Z","updated_at":"2025-01-23T10:21:44.000Z","dependencies_parsed_at":"2024-12-19T12:34:07.900Z","dependency_job_id":"ed90cf9c-eb60-48f6-84b5-4fcabe26b46a","html_url":"https://github.com/turiphro/barcode-shopping-list","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/turiphro%2Fbarcode-shopping-list","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turiphro%2Fbarcode-shopping-list/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turiphro%2Fbarcode-shopping-list/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turiphro%2Fbarcode-shopping-list/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/turiphro","download_url":"https://codeload.github.com/turiphro/barcode-shopping-list/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238455836,"owners_count":19475528,"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":["albert-heijn","barcode","barcode-scanner","barcode-shopping","groceries","python","shopping-list"],"created_at":"2024-12-19T12:28:41.073Z","updated_at":"2025-10-27T07:31:31.099Z","avatar_url":"https://github.com/turiphro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# barcode-shopping-list\nA shopping list that can be operated with a barcode scanner.\n\n\n## Design\nHere's a professional design diagram:\n\n    +------------------------+                                     +-------------------------+\n    | Command line interface | ----------------------------------\u003e | REST API                |\n    |  (Raspberry Pi + LCD)  |                           --------\u003e | (Python + CSV + Docker) |\n    +------------------------+                          /          +-------------------------|\n                ^                                      /\n                |               +---------------------------+\n             barcode            | Web interface             |\n             scanner            | (static React page)       |\n                                +---------------------------+\n\n## Demo\n\n[![Youtube preview](https://img.youtube.com/vi/31pYClpleRU/0.jpg)](https://www.youtube.com/watch?v=31pYClpleRU)\n\n## Run API + WEB\n\nThe API and website can be run on any server. If you want to use the web interface outside of\nyour home (e.g., in the super market), it'll need to be publicly accessible. There's an\nexample config for Nginx in `etc/`. Data is saved in CSV files (hey, it's a hack) which are\nmount to the host OS.\n\nThe barcode lookup API currently supports Albert Heijn and Jumbo products, and plaintext input.\n\nRun:\n\n    docker-compose up\n\nThe API runs on port 7000, the static website on port 7001.\n\nOr run with docker directly:\n\n    docker build -t barcodeapi src/api \u0026\u0026 docker run -it --rm -v $PWD/src/api:/app -p7000:5000 -v $PWD/lists/:/app/lists barcodeapi\n\n    docker run -it --rm -v $PWD/src/web/static:/web -p7001:8080 halverneus/static-file-server\n\n\n## Run CLI\n\nRun:\n\n    python3 src/cli/barcode_cli.py [--hostname your.url.com --port 7000]\n\n    OR:\n\n    docker build -t barcodecli src/cli\n    docker run -it --rm --net host -v $PWD/src/cli:/app barcodecli [--hostname your.url.com --port 7000]\n\nInstructions for installing a raspberry pi with LCD screen:\n\n1. Install Raspberry Pi OS Lite (without GUI)\n2. Configure wifi:\n   https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md\n3. sudo apt update \u0026\u0026 sudo apt install git python3-pip\n3. Checkout this repo in $HOME;\n   might want to `ssh-keygen` and add the key to github first;\n   git clone ssh://git@github.com/turiphro/barcode-shopping-list\n4. Configure LCD screen:\n   `./install_rpi.sh`\n5. Configure autostart; add the run command from above to your `.profile` or `rc.local` file.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturiphro%2Fbarcode-shopping-list","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturiphro%2Fbarcode-shopping-list","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturiphro%2Fbarcode-shopping-list/lists"}