.. CostPal documentation master file, created by
   sphinx-quickstart on Mon Apr 27 00:03:41 2015.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to CostPal homepage!
============================

CostPal is an application for managing your expenses, incomes and other events. CostPal is free, open-source and written in python.
The current version supports Windows and Linux, comes as portable package and was tested on Windows7 (64bit) and WindowsXP (32bit).
This application is distributed under GNU GPL version 2 license.

Features:

* unique design and efficient ui widgets
* flexibility and simplicity
* import of CSV files (with bank account transactions history, some German and Polish banks are supported currently)
* import of draft expenses thru Dropbox (using CostPal Mobile thin client)
* comes with useful example databases


This project is mostly hosted on `Sourceforge.net <https://sourceforge.net/projects/costpal/>`_ site, where you can find:

* news and announcements
* mailing list
* forum
* communicate with author directly
* bugtracker for public bugs
* download releases
* source code


Documentation
=============

.. toctree::
    :maxdepth: 1

    philosophy
    guide
    faq
    roadmap
    developers

CostPal Mobile
==============

CostPal Mobile is an additional application for your smartphone to interoperate with CostPal on your PC (currently available only for Android OS).
With it's smooth intuitive interface (and by using it every day) you can spend minimum time required for tracking your personal expenses (less than 5 minutes a day!).
It's purpose is to act as a scratchpad, not a standalone application for managing personal finance - for that you have CostPal.
Create a draft of transactions during the day, at the time you choose, and at the later time (say once a week) import these into CostPal on PC.
Currently only Dropbox is supported as a cloud storage used for data exchange, it is required as a prerequisite on both smartphone and PC.

See screenshots below.

Features:

* simple and free
* create draft transactions on-the-go
* supports any currency alias you choose to use
* both english and polish translations are available
* synchronization thru Dropbox
* reminders for ocurring transactions and events
* export notification if not exported for longer time

.. note::

  You can install it by downloading .apk file, copying it into Dropbox folder on PC, then use Dropbox app on Android to choose the file and install it.

Downloads
=========

* CostPal v0.9.7 for Windows7 / WindowsXP: `portable <http://sourceforge.net/projects/costpal/files/releases/CostPal_v0.9.7.7z/download>`_ , `installer <http://sourceforge.net/projects/costpal/files/releases/CostPal_v0.9.7_setup.exe/download>`_, `source snapshot <http://sourceforge.net/projects/costpal/files/releases/CostPal_snapshot_v0.9.7.7z/download>`_
* CostPal v0.9.7 for Linux: `source snapshot <http://sourceforge.net/projects/costpal/files/releases/CostPal_snapshot_v0.9.7.7z/download>`_
* CostPal Mobile v1.0 for `Android OS <http://sourceforge.net/projects/costpal/files/releases/CostPal_Mobile_1.0.apk/download>`_

Screenshots
===========

Here are some screenshots to give you a glimpse how CostPal looks in action:

.. image:: images/costpal_screenshot1.png

----

.. image:: images/costpal_screenshot2.png

----

.. image:: images/costpal_screenshot3.png

----

.. image:: images/costpal_screenshot4.png

----

And here are some screenshots of CostPal Mobile in action:

+--------------------------------------------------+--------------------------------------------------+--------------------------------------------------+
| .. image:: images/costpal_mobile_screenshot1.png | .. image:: images/costpal_mobile_screenshot2.png | .. image:: images/costpal_mobile_screenshot3.png |
+--------------------------------------------------+--------------------------------------------------+--------------------------------------------------+
| .. image:: images/costpal_mobile_screenshot4.png |                                                  |                                                  |
+--------------------------------------------------+--------------------------------------------------+--------------------------------------------------+