Skip to content

Latest commit

 

History

History
123 lines (82 loc) · 3.44 KB

INSTALL.md

File metadata and controls

123 lines (82 loc) · 3.44 KB
Raw

Installation

Gourmet is currently available in the form of Flatpak, AppImage, and Python wheel.
For wheels and Flatpak installations, you will need an internet connection.
The AppImage can be copied from one computer to another.

AppImage

The AppImage is available from the release page. Download the it and mark it as executable:

chmod +x ./Gourmet-1.0.0-x86_64.AppImage

It can then be executed by double-clicking on it or launching it from a terminal:

./Gourmet-1.0.0-x86_64.AppImage

Flatpak

The Flatpak contains the full environment, but depends on other flatpak packages, which will be installed automatically.

Install Flatpak if it's not on your system already:

sudo apt-get install flatpak

As Gourmet is still under active development, the flatpak is not available from Flathub, and instead must be downloaded and installed manually.

In a terminal, execute the following:

flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo
sudo flatpak install gourmet-1.0.0.flatpak

You will be prompted with a message regarding the runtime:

Required runtime for io.github.thinkle.Gourmet/x86_64/master (runtime/org.gnome.Platform/x86_64/3.40) found in remote flathub)
Do you want to install it? [Y/n]

Select y, and a list of dependencies will be displayed. Say y to install them all.

At the end, you will be greeted with an Installation complete. message.

You can now launch the Flatpak either from your application menu, or from the command line so:

flatpak run io.github.thinkle.Gourmet

It can be uninstalled so:

flatpak remove io.github.thinkle.Gourmet

Python Wheel

Download the wheel Dependencies must be manually installed.

Unbutu 20.04, Linux Mint 20

Install the following packages from apt:

sudo apt-get update

sudo apt-get install --no-install-recommends python3-gi python3-gi-cairo gir1.2-gtk-3.0 libgirepository1.0-dev libcairo2-dev enchant python3-bs4 python3-ebooklib python3-keyring python3-lxml python3-pil python3-cairo python3-enchant python3-gi python3-gst-1.0 python3-gtkspellcheck python3-requests python3-reportlab python3-selenium python3-setuptools python3-sqlalchemy python3-pip python3-toml gir1.2-poppler-0.18

Finally, install Gourmet:

sudo pip3 install gourmet-1.0.0-py3-none-any.whl

You can now launch Gourmet from a terminal:

$ gourmet
First time? Setting you up with yummy recipes.

Windows 10

Running Gourmet on Windows is still experimental at this stage: the application can run fine, and even exports to PDF. However, there are a couple of issues, and the installation is cumbersome.

Download and install MSYS2 Within the MSYS2 terminal, synchronize your software sources:

    pacman -Syu

Then install some of the dependencies:

    pacman -S mingw-w64-x86_64-gtk3 mingw-w64-x86_64-python3-gobject mingw-w64-x86_64-python-pillow mingw-w64-x86_64-python-sqlalchemy mingw-w64-x86_64-gstreamer mingw-w64-x86_64-poppler mingw-w64-x86_64-python-reportlab

Download the wheel and install it:

    python3 -m pip install gourmet-1.0.0-py3-none-any.whl

Then launch it:

    python3 -m gourmet