Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pinnaculum/gemgemgem
Gemalaya (gemini browser written in QML), Ebooks (gempub and epub) viewer, toolkit to work with gempub archives
https://github.com/pinnaculum/gemgemgem
ebook-reader gemini gemini-browser gemini-client gempub kivy-application python
Last synced: 23 days ago
JSON representation
Gemalaya (gemini browser written in QML), Ebooks (gempub and epub) viewer, toolkit to work with gempub archives
- Host: GitHub
- URL: https://github.com/pinnaculum/gemgemgem
- Owner: pinnaculum
- Created: 2023-07-03T23:06:22.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-03-03T15:37:27.000Z (9 months ago)
- Last Synced: 2024-10-15T06:41:16.144Z (30 days ago)
- Topics: ebook-reader, gemini, gemini-browser, gemini-client, gempub, kivy-application, python
- Language: QML
- Homepage: https://gemalaya.gitlab.io
- Size: 9.82 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# gemgemgem
*gemgemgem* (can be heard as *"J'aime j'aime j'aime"*, meaning
*"I love i love i love"* in French) is a collection of
[Gemini](https://geminiprotocol.net) apps and tools
written in Python. It includes:
- [gemalaya](https://gemalaya.gitlab.io): a keyboard-driven Gemini browser written in QML ([Download AppImage](https://gitlab.com/cipres/gemgemgem/-/releases/continuous-master/downloads/Gemalaya-latest-x86_64.AppImage))
- [gemv](#gemv): a small [Gempub](https://codeberg.org/oppenlab/gempub) viewer
- gempubify: a program to convert *epub* ebooks to gempub archives
## Gemalaya
[Download Gemalaya's latest AppImage (x86_64)](https://gitlab.com/cipres/gemgemgem/-/releases/continuous-master/downloads/Gemalaya-latest-x86_64.AppImage) **Be sure to have all the xcb libraries installed before running the AppImage** (run with *QT_DEBUG_PLUGINS=1* if you get an error the xcb plugin failing to
load)
*Gemalaya* is a keyboard-driven Gemini browser written in QML (PySide6).
Links can be navigated from the keyboard using simple key sequences.
Each link in a gemini page is assigned a number. To follow a link, just type in
the number of the link on the keyboard.
*Gemalaya* supports the automatic proxying of web (http/https) and dweb content
by running an instance of [levior](https://gitlab.com/cipres/levior).
When *levior* is running, web URLs referenced in gemtext documents
are served through the web-to-gemini proxy. It also supports
[Text-to-speech](https://gemalaya.gitlab.io/##text-to-speech).
Please visit [gemalaya's website](https://gemalaya.gitlab.io) for more!
### Install
Download the AppImage or install it with:
```sh
pip install '.[gemalaya,gemalaya-http-proxy]'
python setup.py build_gemalaya install
```
Start the browser by running the *gemalaya* command.
## Convert an epub to gempub
To convert an ebook in the *epub* format to a *gempub* archive,
use the *gempubify* command:
```sh
gempubify book.epub
gempubify -o gembook.gpub book.epub
```
You can also create *gempub* archives by passing the path of
a project file, formatted in YAML.
```sh
gempubify -o manual.gpub docs/gemv/manual/manual.yaml
```
See [the manual's project file](https://gitlab.com/cipres/gemgemgem/-/blob/master/docs/gemv/manual/manual.yaml) for an example.
If you have access to an IPFS (kubo) daemon and want to import the
gempub file to IPFS, use *--ipfs-import*. The CID of the directory
containing the gempub will be printed on the console.
```sh
gempubify --ipfs-import book.epub
```
## Gemv
[Download GemV's latest AppImage (x86_64)](https://gitlab.com/cipres/gemgemgem/-/releases/continuous-master/downloads/GemV-latest-x86_64.AppImage)
*gemv* is a basic gempub viewer written with the Kivy UI library.
It can also open ebooks in the *epub* format by converting them
*on-the-fly* to the *gempub* format.
To install and run the gempub viewer (*GemV*), use the following commands:
```sh
pip install '.[gemv]'
gemv
```