https://github.com/mpereira/tty-solitaire

Play solitaire in your terminal!
https://github.com/mpereira/tty-solitaire

c ncurses solitaire-game tty-game

Last synced: 6 days ago
JSON representation

Play solitaire in your terminal!

• Host: GitHub
• URL: https://github.com/mpereira/tty-solitaire
• Owner: mpereira
• License: mit
• Created: 2010-03-28T19:20:25.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2024-09-22T23:00:44.000Z (3 months ago)
• Last Synced: 2024-11-30T15:08:37.527Z (13 days ago)
• Topics: c, ncurses, solitaire-game, tty-game
• Language: C
• Homepage:
• Size: 479 KB
• Stars: 279
• Watchers: 13
• Forks: 33
• Open Issues: 23
• Metadata Files:
  • Readme: README
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

• fucking-Awesome-Linux-Software - ) - Play solitaire in your terminal! (Applications / Games)
• Awesome-Linux-Software -  - Play solitaire in your terminal! (Applications / Games)

README

        
# -*-org-*-

* tty-solitaire

  Ncurses-based klondike solitaire game.

  #+CAPTION: ttysolitaire gameplay

  [[https://raw.github.com/mpereira/tty-solitaire/master/resources/ttysolitaire.gif]]

** Dependencies

   - Terminal emulator with UTF-8 support

   - C library with multibyte locales support

   - Ncurses with wide-char/UTF-8 support

** Install

   [[https://repology.org/project/tty-solitaire/versions][https://repology.org/badge/vertical-allrepos/tty-solitaire.svg]]

*** Using package managers

**** Arch Linux

     #+begin_src bash

     pacman -S tty-solitaire

     #+end_src

**** macOS

     #+begin_src bash

     brew install tty-solitaire

     #+end_src

**** Debian [[https://wiki.debian.org/DebianTesting][testing]]

     #+begin_src bash

     apt install tty-solitaire

     #+end_src

**** Nix

     #+begin_src bash

     nix-env --install tty-solitaire

     #+end_src

**** Void Linux

     #+begin_src bash

     xbps-install -S tty-solitaire

     #+end_src

**** FreeBSD

     #+begin_src bash

     pkg install tty-solitaire

     #+end_src

**** Slackware

     [[https://www.slackbuilds.org/repository/14.2/games/tty-solitaire/][Via Slackbuilds]].

**** ALT Linux

     #+begin_src bash

     apt-get install tty-solitaire

     #+end_src

   We still need help making tty-solitaire available on Ubuntu, Fedora, Gentoo,

   and more. Please give us a hand at [[https://github.com/mpereira/tty-solitaire/issues/29][issue #29]] if you think you can help.

*** From source

**** Install Ncurses

     tty-solitaire depends on Ncurses. Some platforms provide it out of the box

     and some don't, so you might need to install it yourself.

***** Ubuntu

      #+begin_src bash

      sudo apt-get install libncurses5-dev libncursesw5-dev

      #+end_src

***** macOS

      macOS has Ncurses with wide character support out of the box, so *there's

      nothing you need to do*.

      *If* for some reason you want to use other Ncurses libraries (from

      Macports, Homebrew, etc.) you are able to do it by specifying =LDLAGS= in

      the make invocation. See [[https://github.com/mpereira/tty-solitaire/pull/8][this pull request]] for more information.

**** Install tty-solitaire

     #+begin_src bash

     wget -O tty-solitaire-v1.3.1.tar.gz https://github.com/mpereira/tty-solitaire/archive/v1.3.1.tar.gz

     tar xvf tty-solitaire-v1.3.1.tar.gz

     cd tty-solitaire-1.3.1

     make

     sudo make install

     #+end_src

** Play

   Run in your favorite shell:

   #+begin_src bash

   ttysolitaire

   #+end_src

** Usage

   #+begin_src text

   usage: ./ttysolitaire [OPTIONS]

     -v, --version              Show version

     -h, --help                 Show this message

     -p, --passes               Number of passes through the deck  (default: 3)

         --four-color-deck      Draw unique card suit colors       (default: false)

         --no-background-color  Don't draw background color        (default: false)

   #+end_src

** Development

*** Get the code

    #+begin_src bash

    git clone https://github.com/mpereira/tty-solitaire.git

    #+end_src

*** Run the unit tests

    #+begin_src bash

    make test

    #+end_src

*** [[https://invisible-island.net/ncurses/man/ncurses.3x.html][Ncurses documentation]]

*** [[https://tldp.org/HOWTO/NCURSES-Programming-HOWTO/][Ncurses programming HOWTO]]

** Author

   [[http://murilopereira.com][Murilo Pereira]]

** License

   [[https://github.com/mpereira/tty-solitaire/blob/master/LICENSE][MIT]]