Skip to content

vijinho/kivy-pocket-philosopher

Repository files navigation

Pocket Philosopher

This app which saves, retrieves, edits and displays random aphorisms on random backgrounds.

It runs from Android version 2.2 and is available on Google Play at:

https://play.google.com/store/apps/details?id=com.urunu.aforgizmo

Features

  • Command-line interface utility to manipulate, import/export and display the data
  • Copy aphorisms to the clipboard for sharing in other applications
  • Easily search aphorisms
  • Specify any local folder on your device for image display
  • Backup/Restore the database locally
  • Import data from a remote URL (example included)
  • Download background images from a remote URL (example included)
  • User flash message notifications with timed-removal

What is an Aphorism?

Setup

  • $ pip install --editable .
  • nosetests - run 'nose' tests in tests/

Manual Database Setup

If you wish to setup the database manually instead of automatically when the application runs:

Run python models.py - setup database data/aphorisms.db or :

CREATE TABLE "aphorism" (
    "id" INTEGER NOT NULL PRIMARY KEY,
    "author" VARCHAR(255) NOT NULL,
    "source" VARCHAR(255) NOT NULL,
    "aphorism" TEXT NOT NULL,
    "hashtags" TEXT NOT NULL,
    "created" DATETIME NOT NULL
);
  • Insert the example aphorisms from data/aphorisms.json with aforgizmo insert then hit the RETURN/ENTER key twice

Command Line Usage

Type aforgizmo or failing that:

$ python aforgizmo.py --help 

Usage: aforgizmo [OPTIONS] COMMAND [ARGS]...

Options:
  -v, --verbose
  -l, --logfile FILENAME
  --help                  Show this message and exit.

Commands:
  add     Add an aphorism.
  dump    Dump all aphorisms to a file.
  get     Get an aphorism by ID.
  insert  Insert aphorisms by file.
  list    Show all aphorisms.
  random  Get a random aphorism.
  remove  Remove an aphorism by ID.
  search  Search for an aphorism by tag.
  show    Show an aphorism by ID for display.

Running the Kivy App

  • On Mac OS X: kivy main.py - On other platforms it may 'just work' with python main.py
  • Alternatively, run .

See Also

This app is written in Python using the Kivy library for cross-platform support (Android, IOS, Windows, Linux, Mac OSX). See http://kivy.org/docs/guide/packaging.html for instructions on packaging the application for the different platforms.

Copyright 2014 Vijay Mahrra http://www.urunu.com/

About

Pocket Philosopher - Find this on Google Play. A Python/Kivy project to edit, display and share aphorisms in a fun way. Project formerly named 'aforgizmo'

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published