Skip to main content

Read wikipedia articles distraction free

Project description

WikiReader

WikiReader is a simple wikipedia browser tool writen in Python for reading Wikipedia articles without distraction. It uses Suckless' dmenu for finding articles.

It is written for my own purposes and is deliberately kept simple.

Installation

To install WikiReader, simply run:

pip install wikireader

WikiReader was written in Python 3.8.5 and had dmenu as an external dependency. To install dmenu:

On Debian/Ubuntu

sudo apt install dmenu

On Arch Linux:

pacman -S dmenu

WikiReader also relies on PyQt5, so it needs the dependencies of that package as well.

Usage

Run the command wikireader. A dmenu instance will popup on your screen. Here you can write a keyword or query. The dmenu will disappear and reappear with suggestions to articles. After chosing one, the article will be loaded and shown in a simplified html form.

Config

Configuration is still in it's early stages. The first implementation is in version 0.0.4. At the moment you can only set the theme. The config folder is in ~/.config/wikireader/. There will be a config.json. If it is not there, run the wikireader command once. The program will create the folder and the default config files. There will be a css folder as well with availabel themes, at the moment only a dark- and a light theme. Be free to create your own theme, but beware that you give it a different name. In the config.json you can set the theme, by setting the css filename without the .css extentsion:

{
    "theme": "light"
}

The default is dark as I prefer that.

Licence

The package is released under MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wikireader-0.0.5.tar.gz (8.0 kB view hashes)

Uploaded Source

Built Distribution

wikireader-0.0.5-py3-none-any.whl (12.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page