Python/Tk GUI browser for Gemini
Project description
Picross is a minimal and usable gemini:// browser written in Python and tkinter.
Installation
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
Usage
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.
Downloading files:
Warning: this feature will be deprecated soon.
When the server responds with something that isn't decodable as a string, McRoss will download the response body as a file with a helper, for example, gemget.
Configuration:
# example for gemget; $URL is self-explanatory, and $DEST is just download-dest
# i.e. where the files will be downloaded to.
download-cmd = "gemget $URL -d $DEST"
download-dest = "~/Downloads/"
The download job will then be handed to the helper of your choice.
Note: if your download-dest
contains spaces, you need to escape them with
2 backslashes. Like this: ~/My\\ Downloads
. One for shell and one for
TOML.
Development
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.