TutCatalogPy2 (WIP)

About

A catalog for your tutorials. Keeps a cache of the tutorials for fast access and search. Developed in Python and Qt/PySide2.

This incarnation of the TutCatalog is the fourth one, after 2 in C++ and another one in Python.

Main project repo: https://gitlab.com/iborco-software/tutcatalog/tutcatalogpy2

Project Status

• the main catalog application
  • parse and display info from info.tc files
  • [TODO] edit the info.tc files
• [TODO] the viewer application

Install

You need to install first poetry in order to handle any additional dependencies.

Once you have poetry installed, clone the sources and run the commands bellow inside your source directory.

# go to your source folder
cd .../tutcatalogpy2

# setup virtual environment and install dependencies
poetry install

# start a shell in the virtual environment
poetry shell

# start the catalog
tutcatalogpy

# start the viewer
tutviewerpy

macOS

# (macos) create py2app stubs
python setup-catalog.py py2app -A
python setup-viewer.py py2app -A

Linux

# install the *.desktop files
cp examples/linux/*.desktop ~/.local/share/applications

# fix tutcatalogpy2.desktop paths
vim ~/.local/share/applications/tutcatalogpy2.desktop

# fix infoviewer.desktop paths
vim ~/.local/share/applications/infoviewer.desktop

# register mime for *.tc files
mkdir -p ~/.local/share/mime/packages/
cp examples/linux/user-extension-tc.xml ~/.local/share/mime/packages/

# update mime database
update-mime-database ~/.local/share/mime

# test mime
# empty files are identified as text/plain so we add something to the file
echo -e "\n\n" > info.tc

mimetype info.tc
info.tc: application/x-tc

gio info info.tc  | grep "standard::content-type"

# associate *.tc with in the Files app

Transitional

# for C++ infoviewer
sudo apt install ffmpeg

Misc

• scrapper tool
• development notes