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.

-  ``aforgizmo COMMAND --help``
-  ``sqlite3 data/aphorisms.db`` see http://www.sqlite.org/cli.html

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
--------

-  https://github.com/jcalazan/random-quotes - A similar Kivy App

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/