# Karoto Shopping List
A Linux mobile app that helps you with your groceries.
It is not just a fancy replacement for your notes app but instead works a bit like a stock management software.
The heart of the app is a list with things you always want to have at home.
Before you go to the grocery store or whereever you get your stuff from you can go through this list and check for every item how much you have in your storage.
The app then generates the shopping list for you which makes it impossible to forget anything.
## Additional features
- **only once:**
If you need something like a new knive or some new plates e.g. there is the "only once" option where the item automatically gets deleted as soon as you got it once.
- **tags:**
You can add tags to your items and filter for them.
One example workflow could be to tag everything thats in the fridge with a tag called "Fridge" and when you check whats missing you filter for fridge stuff and only open the fridge once.
The same can be done while shopping: Tag items for where you can get them and click on the tag when you are there.
- **hide temporary:**
Imagine you have a long shopping list but not enough money with you or some items would be to heavy/big to carry so you decide to get it next time.
Now you can click on the *Hide temporary* button and the item disappears until you restart the app so it does not annoy you.
# Screenshots
#### Storage Feed (you go through this list at home):
#### Shopping Feed (for in the store e.g.):
#### Storage Feed filtered for the tag called `Vegetables`:
# Installing
Karoto depends on python3 and PyQt6 to run.
All instructions assume you have cloned the repository and are in its root folder:
```
git clone https://codeberg.org/DrRac27/karoto.git
cd karoto
```
## No installing
Without installing you can use `./helper.sh run` to start and test the app.
## Flatpak (the easiest if you are not using Arch Linux)
Karoto is on Flathub: https://flathub.org/apps/details/page.codeberg.DrRac27.Karoto
## Using pip
Note: It seems like the dependency PyQt6 is not (yet?) available for ARM via pip.
You should be able to install it if you add `--no-deps` to the pip command and install the dependencies manually (your package manager probably has PyQt6).
First make sure you have [pip installed](https://packaging.python.org/en/latest/guides/installing-using-linux-tools/#installing-pip-setuptools-wheel-with-linux-package-managers) and then:
```
sudo pip install karoto
sudo install -Dm 644 packaging/karoto.desktop /usr/share/applications/
sudo install -Dm 644 packaging/karoto.svg /usr/share/icons/hicolor/scalable/apps/
```
This will install it system-wide.
If you want to install it for the user only use `~/.local/share/applications` and `~/.icons` for the commands above and omit the `sudo`.
## postmarketOS / Alpine
There is an APKBUILD you can build using `abuild` in this repo.
Follow the [setup instructions](https://wiki.alpinelinux.org/wiki/Creating_an_Alpine_package#Setup_your_system_and_account) for abuild and create the package using `./helper.sh postmarketos-package` in the root folder of this project.
You can now install the resulting package. Depending on how you set up abuild the command for this may be something like `sudo apk add --allow-untrusted ~/packages/path/to/built/app.apk`.
## Arch Linux / Arch Linux ARM / DanctNIX / Kupfer / ...
There are the AUR packages [karoto](https://aur.archlinux.org/packages/karoto) and [karoto-git](https://aur.archlinux.org/packages/karoto-git).
If you e.g. use yay:
```
yay -S karoto
```
If you want to change something before installing there is also a PKGBUILD in `packaging/archlinux` (like for postmarketOS) that you can install using the helper script.
# Roadmap aka some ideas that may get implemented soon™ (by you?)
- Translation
- Feedback via feedbackd
- More styles? Dark style? Custom user styles?
- Multiple lists to choose from via GUI (already supported via CLI)?
- support for Android (F-Droid)? PRs welcome! (pyqtdeploy?)
# Dev Notes
- if you want git to stop annoying you with the changed tests/data files you can use
```
git update-index --assume-unchanged <file>
```
If you want to start tracking changes again:
```
git update-index --no-assume-unchanged <file>
```
([src](https://stackoverflow.com/a/11366713))
# License
This app is dual-licensed under MIT for people that care about licenses/legal stuff and under the anarchist license for those who don't.
Raw data
{
"_id": null,
"home_page": "",
"name": "karoto",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "shopping,list,carrot,storage,stock,management,cart,basket",
"author": "DrRac27",
"author_email": "drrac27@riseup.net",
"download_url": "https://files.pythonhosted.org/packages/4b/dd/6ad07a5671e36bd635575a6139ee98d32b9e688dde33bcaa264741956249/karoto-0.2.tar.gz",
"platform": null,
"description": "# Karoto Shopping List\n\nA Linux mobile app that helps you with your groceries.\n\nIt is not just a fancy replacement for your notes app but instead works a bit like a stock management software.\nThe heart of the app is a list with things you always want to have at home.\nBefore you go to the grocery store or whereever you get your stuff from you can go through this list and check for every item how much you have in your storage.\nThe app then generates the shopping list for you which makes it impossible to forget anything.\n\n## Additional features\n- **only once:**\nIf you need something like a new knive or some new plates e.g. there is the \"only once\" option where the item automatically gets deleted as soon as you got it once.\n- **tags:**\nYou can add tags to your items and filter for them.\nOne example workflow could be to tag everything thats in the fridge with a tag called \"Fridge\" and when you check whats missing you filter for fridge stuff and only open the fridge once.\nThe same can be done while shopping: Tag items for where you can get them and click on the tag when you are there.\n- **hide temporary:**\nImagine you have a long shopping list but not enough money with you or some items would be to heavy/big to carry so you decide to get it next time.\nNow you can click on the *Hide temporary* button and the item disappears until you restart the app so it does not annoy you.\n\n# Screenshots\n#### Storage Feed (you go through this list at home):\n\n#### Shopping Feed (for in the store e.g.):\n\n#### Storage Feed filtered for the tag called `Vegetables`:\n\n\n# Installing\n\nKaroto depends on python3 and PyQt6 to run.\nAll instructions assume you have cloned the repository and are in its root folder:\n```\ngit clone https://codeberg.org/DrRac27/karoto.git\ncd karoto\n```\n\n## No installing\nWithout installing you can use `./helper.sh run` to start and test the app.\n\n## Flatpak (the easiest if you are not using Arch Linux)\nKaroto is on Flathub: https://flathub.org/apps/details/page.codeberg.DrRac27.Karoto\n\n## Using pip\nNote: It seems like the dependency PyQt6 is not (yet?) available for ARM via pip.\nYou should be able to install it if you add `--no-deps` to the pip command and install the dependencies manually (your package manager probably has PyQt6).\n\nFirst make sure you have [pip installed](https://packaging.python.org/en/latest/guides/installing-using-linux-tools/#installing-pip-setuptools-wheel-with-linux-package-managers) and then:\n```\nsudo pip install karoto\nsudo install -Dm 644 packaging/karoto.desktop /usr/share/applications/\nsudo install -Dm 644 packaging/karoto.svg /usr/share/icons/hicolor/scalable/apps/\n```\nThis will install it system-wide.\nIf you want to install it for the user only use `~/.local/share/applications` and `~/.icons` for the commands above and omit the `sudo`.\n\n## postmarketOS / Alpine\n\nThere is an APKBUILD you can build using `abuild` in this repo.\nFollow the [setup instructions](https://wiki.alpinelinux.org/wiki/Creating_an_Alpine_package#Setup_your_system_and_account) for abuild and create the package using `./helper.sh postmarketos-package` in the root folder of this project.\nYou can now install the resulting package. Depending on how you set up abuild the command for this may be something like `sudo apk add --allow-untrusted ~/packages/path/to/built/app.apk`.\n\n## Arch Linux / Arch Linux ARM / DanctNIX / Kupfer / ...\nThere are the AUR packages [karoto](https://aur.archlinux.org/packages/karoto) and [karoto-git](https://aur.archlinux.org/packages/karoto-git).\nIf you e.g. use yay:\n```\nyay -S karoto\n```\nIf you want to change something before installing there is also a PKGBUILD in `packaging/archlinux` (like for postmarketOS) that you can install using the helper script.\n\n# Roadmap aka some ideas that may get implemented soon\u2122 (by you?)\n- Translation\n- Feedback via feedbackd\n- More styles? Dark style? Custom user styles?\n- Multiple lists to choose from via GUI (already supported via CLI)?\n- support for Android (F-Droid)? PRs welcome! (pyqtdeploy?)\n\n\n# Dev Notes\n- if you want git to stop annoying you with the changed tests/data files you can use\n```\ngit update-index --assume-unchanged <file>\n```\nIf you want to start tracking changes again:\n\n```\ngit update-index --no-assume-unchanged <file>\n```\n([src](https://stackoverflow.com/a/11366713))\n\n# License\nThis app is dual-licensed under MIT for people that care about licenses/legal stuff and under the anarchist license for those who don't.\n",
"bugtrack_url": null,
"license": "",
"summary": "A shopping list app for Linux Mobile",
"version": "0.2",
"project_urls": null,
"split_keywords": [
"shopping",
"list",
"carrot",
"storage",
"stock",
"management",
"cart",
"basket"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "032d8b8f81ed623fc136218da2944e58318cb397af36090d35d0be4d24e6ec6b",
"md5": "75d859e376724a8ae1f5a0e86d870858",
"sha256": "27da2127a55e0750d0a6ee02842d03a8fd7e6868216104906567af0e52b63531"
},
"downloads": -1,
"filename": "karoto-0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "75d859e376724a8ae1f5a0e86d870858",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 23031,
"upload_time": "2023-06-21T18:09:35",
"upload_time_iso_8601": "2023-06-21T18:09:35.023277Z",
"url": "https://files.pythonhosted.org/packages/03/2d/8b8f81ed623fc136218da2944e58318cb397af36090d35d0be4d24e6ec6b/karoto-0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4bdd6ad07a5671e36bd635575a6139ee98d32b9e688dde33bcaa264741956249",
"md5": "43b4db8e734ca18aabdfc73317d83ee1",
"sha256": "2049ee953cdf912208061fe76cc8a70cac9b4aa0549acd8b39d97979ac46dbf8"
},
"downloads": -1,
"filename": "karoto-0.2.tar.gz",
"has_sig": false,
"md5_digest": "43b4db8e734ca18aabdfc73317d83ee1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 20397,
"upload_time": "2023-06-21T18:09:36",
"upload_time_iso_8601": "2023-06-21T18:09:36.654291Z",
"url": "https://files.pythonhosted.org/packages/4b/dd/6ad07a5671e36bd635575a6139ee98d32b9e688dde33bcaa264741956249/karoto-0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-21 18:09:36",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "karoto"
}
JSON