123 lines
3.4 KiB
Org Mode
123 lines
3.4 KiB
Org Mode
# -*-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]]
|