Code Monkey home page Code Monkey logo

ppub's Introduction

pPub 1.1

Version 1.1 by Thanasis Georgiou ([email protected])

Description

pPub is a simple epub reader written in Python using GTK3 and WebKit. It has most features expected from a book reader and some support for ebook-convert. It's licenced under GPLv2.

Features

  • Bookmarks use MD5 hashes so filenames are irrelevant.
  • Keyboard shortcuts.
  • Table of contents support.
  • Night mode and custom user CSS support.
  • Javascript toggle.
  • Basic support for ebook-convert.
  • Support for files that don't pass epubcheck.
  • Lightweight.

Here is a screenshot.

Installation

  • For Archlinux: Install ppub from AUR.

  • For Salix: slapt-src -i ppub (Probably not working anymore, if anyone can confirm notify me)

  • For other Linux distros and BSDs:

    make install

This command will install ppub under "/usr" prefix and configure it to invoke python 2.x via "/usr/bin/python2" command. To alter this behavior set PREFIX and PYTHON environment variables, eg.:

PREFIX=/usr/local PYTHON=`which python2.7` make install

Also note, icons and desktop file are installed by default. If you want to install only the program itself, invoke make with "install-bin" target instead of "install".

Configuration

Most features can be configured from inside the application with these exceptions:

  • cachedir = Path to cache, default is /tmp/ppub-cache-username. If you change this, keep the trailing '/'.
  • usercss = Path to custom CSS folder. Each file in that folder will appear as a separate menu entry. If invalid or 'None', custom CSS is disabled. Config is saved at ~/.ppub.conf. Bookmarks are stored inside the same file.

Help:

If you find a book that does not work, please extract it (like a zip file) and attach any .opf or .ncx it has inside to your bug report. These will help me resolve the problem. Also feel free to email me requests.

Contributors:

-Tristan Rice (https://github.com/d4l3k) -ehainry (https://github.com/ehainry) -Laurent Bigonville (https://github.com/bigon) -Laurent Peuch (https://github.com/Psycojoker) -Dmitrij D. Czarkoff (https://github.com/czarkoff)

Thanks for trying pPub out!

ppub's People

Contributors

thgeorgiou avatar d4l3k avatar czarkoff avatar bigon avatar psycojoker avatar

Watchers

luke chen avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.