mensa

CLI tool to query the menu of canteens contained in the OpenMensa database.

Features

[X] Runs on Linux, macOS and Windows.
[X] Custom filters and favourites using CLI flags or the optional configuration file.
[X] List canteens close to you based on GeoIP.
[X] All request are cached locally.
[X] Fuzzy date parsing based on datetimeparser.
[X] List your favourite meals in canteens close to your location.
[X] JSON Output

example

Installation

Cargo

Only nightly Rust supported at the moment.

console $ cargo install --git https://github.com/MalteT/mensa

Nix

This is a Nix Flake, add it to your configuration or just test the application with:

console $ nix run github:MalteT/mensa

Usage

See mensa --help.

mensa meals will show meals served today for the default canteen mentioned in the configuration. If no such configuration exists, try mensa meals --id 63. You can find the id for your canteen using
mensa canteens lists canteens near you based on your current IP in a default radius of 10km.
mensa tags will list the currently known meal tags like "12 Nuts".

Examples

#

Meals on monday (Click me!)

You can omit the -i/--id if you've configured a default id in the config.toml.

```console $ mensa meals -d mon -i 63

Leipzig, Mensa am Park ┊ ┊ ╭───╴Bohnengemüse ┊ ├─╴Gemüsebeilage 🌱 ┊ ╰╴( 0.55€ ) ... ```

Canteens near your location (Click me!)

```console $ mensa canteens

70 Leipzig, Cafeteria Dittrichring Dittrichring 21, 04109 Leipzig

63 Leipzig, Mensa am Park Universitätsstraße 5, 04109 Leipzig ... ```

All currently known tags (Click me!)

```console $ mensa tags

 0 Acidifier
   Contains artificial acidifier

 1 Alcohol
   Contains alcohol

 2 Antioxidant
   Contains an antioxidant
...

```

Meals of canteens close to your location next sunday (Click me!)

```console $ mensa meals close --date sun

Leipzig, Cafeteria Dittrichring ┊ ┊ ╭───╴Vegetarisch gefüllte Zucchini ┊ ├─╴Vegetarisches Gericht 🧀 ┊ ├╴Rucola-Kartoffelpüree ┊ ├╴Tomaten-Ratatouille-Soße ┊ ╰╴( 2.65€ ) 2 11 12 19

Leipzig, Mensa am Park ┊ ┊ ╭───╴Apfelrotkohl ┊ ├─╴Gemüsebeilage 🌱 ┊ ╰╴( 0.55€ ) 2 ... ```

Count OpenMensa's canteens (Click me!)

console $ mensa canteens --all --json | jq '.[].id' | wc -l 704

Configuration (Optional)

See config.toml for an example. Copy the file to: - $XDG_CONFIG_DIR/mensa/config.toml on Linux, - $HOME/Library/Application Support/mensa/config.toml on macOS, - {FOLDERID_RoamingAppData}\mensa\config.toml on Windows

License: MIT