Reasonably Usable Python/Tk Gemini Browser
TOFU: Create file if it didn't exist
9702d7a7 — Frederick Yin 3 years ago
Version bump 0.6.2
79d81d17 — Frederick Yin 3 years ago
Meta: 0.6.2 followup



You can also use your local clone with git send-email.

Picross is a minimal and usable gemini:// browser written in Python and tkinter.


Install from PyPI for releases:

# do user install or grant privilege
pip install picross --user

or install from source:

git clone https://git.sr.ht/~fkfd/picross
cd picross
pip install -r requirements.txt --user
python setup.py install --user


Run picross to open browser, and picross -h to get a full list of CLI arguments which modify appearance or behavior.

The priority is CLI arg > config file > default.

#Keyboard shortcuts:

  • Hold Alt to see possible button shortcuts underlined. This is what Qt calls Accelerator Keys.
  • Ctrl-r / F5: refresh page.
  • Ctrl-l: jump to address bar.
  • Ctrl-t: open new tab.
  • Ctrl-w: close current tab.
  • Ctrl-PgUp/PgDown: switch to tab above/below.


To get started:

git clone https://git.sr.ht/~fkfd/picross
cd picross
# you can set up virtualenv here if you want
# install dependencies
# escalate/limit privilege if necessary
pip install -r requirements.txt
python -m picross

Mailing list for sending patches and anything related to Picross: ~fkfd/picross@lists.sr.ht

If you're not familiar with the mailing list workflow, check out git-send-email.io and mailing list etiquette. useplaintext.email also has useful plaintext setup tips for various email clients.