Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jubalh/nudoku
ncurses based sudoku game
https://github.com/jubalh/nudoku
Last synced: 1 day ago
JSON representation
ncurses based sudoku game
- Host: GitHub
- URL: https://github.com/jubalh/nudoku
- Owner: jubalh
- License: gpl-3.0
- Created: 2015-01-16T15:42:24.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-09-10T10:27:11.000Z (4 months ago)
- Last Synced: 2025-01-11T02:07:05.054Z (8 days ago)
- Language: C
- Homepage: http://jubalh.github.io/nudoku/
- Size: 257 KB
- Stars: 335
- Watchers: 10
- Forks: 59
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-open-source-games - Nudoku - Ncurses based CLI sudoku game. (Native / Puzzle/card/board)
README
# nudoku #
nudoku is a ncurses based sudoku game.
## Install ##
nudoku is easily installable via many package managers.
[](https://repology.org/project/nudoku/versions)
#### Dependency ###
- ncurses
- cairo (optional: for PDF/PNG output)
#### From source ####
Get the latest `.tar.xz` [release](https://github.com/jubalh/nudoku/releases) and extract it.
Then run:
```sh
./configure
make
./src/nudoku
```
For the git version you will have to do:
```sh
git clone https://github.com/jubalh/nudoku
cd nudoku
autoreconf -i
./configure
make
./src/nudoku
```
Add `-DDEBUG` to `make` to have some debug output.
nudoku can also output sudokus in PDF and PNG format (see `man nudoku` -p/-i/-n).
You need to have cairo installed and configure with:
```sh
./configure --enable-cairo
```
## Usage ##
For normal interactive GUI run `nudoku`.
To print two PDF pages with 8 hard sudokus run `nudoku -p riddle.pdf -n 8 -d hard`.
To get a PNG with an easy sudoku run `nudoku -i sudoku.png -d easy`.
See `man nudoku` to learn more.
## I18n ##
For i18n support you need to set `LANGUAGE` variable:
```sh
export LANGUAGE=lang
```
Where `lang` is the translation of choice. See the list of supported languages in `po/LINGUAS` file.
## Contributing ##
If you plan to add/update the translation please follow these guidelines with examples:
1. Fork this repository and create a new git branch with language abbreviation as a name, e.g. `es`:
```sh
cd nudoku # your forked git repository
git checkout -b es
```
2. For new translation add language to `po/LINGUAS` and create `.po` file:
```sh
echo es >> po/LINGUAS && cp po/nudoku.pot po/es.po
```
3. Replace placeholders in uppercase in the head of the file with your information. Add translations for *(preferably)* each `msgid`.
4. Check your `.po` file with `msgfmt` for any errors:
```sh
msgfmt es.po # should not produce any output
```
5. Push your branch to remote and create PR:
```sh
git push origin es
```
If you add changes to source code make sure to update potfiles as well:
```sh
cd po # if you inside nudoku directory
make update-po
```
## Bugtracker ##
https://github.com/jubalh/nudoku/issues