Python HTML Tcl Shell Perl Makefile
shlomif Clarify the solver dialog msg on hint-on-intract
so people will not think it was solved.
Latest commit 2bbea25 Aug 5, 2018

PySol Fan Club edition

This is an open source and portable (Windows, Linux and Mac OS X) collection of Card Solitaire/Patience games written in Python. Its homepage is .

The maintenance branch of PySol FC on GitHub by Shlomi Fish and by some other people, has gained official status, ported the code to Python 3, and implemented some other enhancements.

  • Build Status AppVeyor Build status






Running from source without installation.

You can run from the source directory:


After following steps similar to these (on Mageia Linux ):

Step 1 - install the dependencies

On Mageia you can do:

sudo urpmi git make pygtk2 pygtk2.0-libglade gnome-python-canvas tkinter

On Debian / Ubuntu / etc. you can do:

sudo apt-get install -y ack-grep cpanminus libperl-dev make perl python-glade2 python-gnome2 python-gnome2-dev python-gtk2 python-setuptools python-tk

Step 2 - build PySol.

$ git clone
$ cd PySolFC
$ # Now make sure you have installed the dependencies.
$ gmake test
$ gmake rules
$ ln -s data/images images
$ tar -xvf PySolFC-Cardsets-2.0.tar.bz2 # Need to be downloaded from sourceforge
$ mkdir -p ~/.PySolFC
$ rmdir ~/.PySolFC/cardsets
$ ln -s "`pwd`/PySolFC-Cardsets-2.0" ~/.PySolFC/cardsets
$ python

Note! If you are using a Debian derivative (e.g: Debian, Ubuntu, or Linu Mint) and you are getting an error of "No cardsets were found !!! Main data directory is [insert dir here] Please check your PySol installation.", then you likely installed the cardsets package which has removed some files that are needed by pysol from source (without the debian modifications).

Please uninstall that package and use the cardsets archive from per the instructions above.

Alternate toolkit.

  • Python2 (2.7 or later)

  • Kivy (10.0 or later)

  • Features:

    • Sound support integrated.
    • Android apk build support.
  • Running from source without installation:

python2 --kivy

Configuring Freecell Solver

If you want to use the solver, you should configure freecell-solver ( ) by passing the following options to its CMake-based build-system: -DMAX_NUM_FREECELLS=8 -DMAX_NUM_STACKS=20 -DMAX_NUM_INITIAL_CARDS_IN_A_STACK=60.

Install Extras.

  • Music

  • Copy some music files (mp3 for example) to ~/.PySolFC/music/

  • Original PySol music can be downloaded from:

  • Cardsets

  • Copy cardsets to ~/.PySolFC/cardsets

  • Additional cardsets can be downloaded from the PySolFC project page:

Related repositories and links


Other open source solitaires:

  • - web-based and written in Scala
  • Solitairey - web-based written in JavaScript
  • KPat - desktop-based for KDE.
  • Aisleriot - desktop-based by the GNOME project with relatively limited functionality.



To facilitate coordination about contributing to PySol, please join us for a real time Internet chat on the ##pysol chat room on Freenode (note the double octothorpe/hash-sign/pound-sign) . We may set up chat rooms on different services in the future.

In addition, we set up a Google Group for discussing open source card games which will also be used for discussing PySol. Feel free to subscribe or post!