Score wines. Remember experiences. Discover patterns.
ViNotes is a free, open-source wine tasting journal for Android. It lets you score and document wines across four dimensions — appearance, nose, palate, and finish — so you can build a personal record of every bottle you've ever tried.
Whether you're casually curious or a seasoned enthusiast, ViNotes helps you remember what you tasted, where you tried it, and whether you'd drink it again.
No ads. No accounts. No Google Play Services required. Your tasting notes live on your device.
- 🍷 Structured tasting notes — score wines on clarity, colour intensity, nose, palate, finish and more, following a professional tasting framework
- 📋 Wine cellar — browse, filter and search all your wines by region, vintage or grape variety
- 📊 Statistics — visualise your ratings by year and region with interactive charts
- 📍 One-tap location — autofill the venue field using your GPS position with reverse geocoding via OpenStreetMap
- 🔄 Catalog sync — download a curated wine database and keep it up to date with delta syncing
- 📁 Local JSON import — import your own wine catalogue from a file, no internet required
- 🌙 Dark & light theme — fully themed UI with a warm, elegant wine-inspired palette
- 🔒 Privacy-first — works completely offline, no account needed, no tracking
| Dashboard | Tasting Form | Wine Detail | Statistics |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
ViNotes is built with modern Android development practices from the ground up.
| Layer | Technology |
|---|---|
| UI | Jetpack Compose + Material 3 |
| Architecture | MVI (Model–View–Intent) |
| Dependency Injection | Hilt |
| Local Database | Room (SQLite) |
| Networking | Retrofit + kotlinx.serialization |
| Location | Android LocationManager |
| Geocoding | Nominatim (OpenStreetMap) |
| Charts | MPAndroidChart |
| Image loading | Coil |
| Date handling | kotlinx.datetime |
Every screen follows a strict MVI pattern with four dedicated files — State, Event, Effect, and ViewModel. ViewModels are pure Kotlin with no Android framework dependencies except through injected use cases, making the business logic fully testable.
UI Layer Composables collect State, send Events
↕
ViewModel Processes Events → updates State, emits Effects
↕
Use Cases Single-responsibility business logic
↕
Repositories Abstract data sources behind interfaces
↙ ↘
Room Retrofit
ViNotes ships with a community-maintained wine catalogue hosted on GitHub Pages. The sync system is designed to be lightweight and bandwidth-friendly:
manifest.json— fetched first; lists all available files with checksumsfull.json— the complete catalogue, used on first install or manual resetdelta-YYYY-MM-DD.json— incremental updates with only added, changed, or removed wines
The app tracks the last applied delta date in Room and only downloads what it hasn't seen yet. A GitHub Action automatically regenerates the delta files and updates the manifest whenever the source catalogue changes.
Want to add wines to the catalogue? Contributions are welcome in the catalog branch! Add your own issue/pull request!
- Android 8.0 (API 26) or higher
- Android Studio Hedgehog or newer (for building from source)
git clone https://github.com/T0liver/vinotes.git
cd vinotes
./gradlew assembleDebugInstall on a connected device:
adb install app/build/outputs/apk/debug/app-debug.apk| Source | Link |
|---|---|
| F-Droid | coming soon |
| Direct APK | Releases |
Contributions of all kinds are welcome!
- 🐛 Found a bug? Open an issue with steps to reproduce
- 💡 Have an idea? Open an issue with the
enhancementlabel - 🍷 Know your wines? Add entries to the wine catalog!
- 🔧 Want to code? Fork the repo and open a pull request — please discuss larger changes in an issue first
- Follow the existing MVI pattern for any screen changes
- No proprietary libraries — keep it F-Droid compatible
- New screens need all five files:
State,Event,Effect,ViewModel,Screen - Match the code style and naming conventions already in the project
See LICENCE for the full licence text.
- OpenStreetMap contributors & Nominatim for free, open geocoding
- MPAndroidChart by Philipp Jahoda for the chart library
- Shields.io for the README badges



