TomBursch/kitchenowl

KitchenOwl

A smart grocery list and recipe manager.

Website | Docs | Self-Hosting | Matrix

Stars Translation Matrix License GitHub release (latest by date) Docker pulls

🍫 🥘 🍽

KitchenOwl is a smart self-hosted grocery list and recipe manager. Easily add items to your shopping list before you go shopping. You can also create recipes and get suggestions on what you want to cook. Track your expenses so you know how much you've spent.

• Native Mobile/Web/Desktop apps with a great design
• Add items to your shopping list and sync them in real-time with multiple users
• Partial offline support, so you don't lose track of what to buy even when there is no signal
• Manage recipes and add them to your shopping list
• Share recipes with friends and family
• Create a meal plan to always know what you'll be eating
• Manage balances and track expenses of your household

Please keep in mind that this project is still in development.

For a full list check out the website. For a list of planned features, take a look at the Roadmap!

📱 Screenshots

Groceries page

Recipe page

Plan page

Expense page

🤖 App Install

Get it in your favorite store or find the current release for your operating system on the releases page.

🚀 Get started

Please take a look at the get started guide.

🙌 Contributing

From opening a bug report to creating a pull request: every contribution is appreciated and welcomed. If you're planning to implement a new feature or change the API please create an issue first. This way, we can ensure your work is not in vain. For more information see Contributing or get in contact by joining our Matrix space.

🌍 Translations

You can help translate the App into your language by using Weblate!

Translation status

🛎️ Stay Up-to-Date

KitchenOwl is moving fast, to stay updated consider starring and watching the releases of this repository.

💬 Status

• [x] Public Alpha: Still working on stuff (rarely things might break)
• [ ] Public Beta: Stable and most planned features complete
• [ ] Public: Production-ready

📚 Related

• Website
• Docs
• KitchenOwl Backend Repository
• KitchenOwl Website Repository
• KitchenOwl Python Client Repository
• KitchenOwl Home Assistant Integration Repository
• DockerHub
• Recipe scrapers used for scraping recipes from the web
• Weblate is helping with continuous localization as part of their ongoing support for open-source software projects.

🔨 Built With

• Flask
• Flutter
• Docker

🍀 Contributors

https://contrib.rocks/image?repo=tombursch/KitchenOwl

📜 License

KitchenOwl is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the AGPL-3.0 License.