{"id":17168244,"url":"https://github.com/vladimirmarkelov/solkit","last_synced_at":"2025-04-13T15:36:11.069Z","repository":{"id":55390452,"uuid":"314939098","full_name":"VladimirMarkelov/solkit","owner":"VladimirMarkelov","description":"A solitaire collection and solitaire construction kit for terminal","archived":false,"fork":false,"pushed_at":"2021-01-11T06:10:01.000Z","size":243,"stargazers_count":34,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-06T05:46:46.348Z","etag":null,"topics":["cli","command-line","game","rust","solitaire","solitaire-card-game","solitaire-game","terminal"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VladimirMarkelov.png","metadata":{"files":{"readme":"README.md","changelog":"changelog","contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-11-22T01:48:21.000Z","updated_at":"2025-01-18T04:03:21.000Z","dependencies_parsed_at":"2022-08-14T23:10:48.822Z","dependency_job_id":null,"html_url":"https://github.com/VladimirMarkelov/solkit","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VladimirMarkelov%2Fsolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VladimirMarkelov%2Fsolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VladimirMarkelov%2Fsolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VladimirMarkelov%2Fsolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VladimirMarkelov","download_url":"https://codeload.github.com/VladimirMarkelov/solkit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248737373,"owners_count":21153756,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","game","rust","solitaire","solitaire-card-game","solitaire-game","terminal"],"created_at":"2024-10-14T23:11:30.818Z","updated_at":"2025-04-13T15:36:11.048Z","avatar_url":"https://github.com/VladimirMarkelov.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Table of Contents\n\n- [Intro](#intro)\n    - [Look and feel](#look-and-feel)\n- [Installation](#installation)\n    - [Precompiled binaries](#precompiled-binaries)\n    - [Portable mode](#portable-mode)\n- [License](#license)\n- [Credits](#credits)\n\n[Documentation](/docs/usage.md)\n\n## Intro\n\n`SolKit` is a solitaire construction kit and a lot of playable solitaires out of the box.\nThe application contains 26 built-in solitaires (23 distinct ones and 3 modifications).\nMoreover, you can create a new solitaire with your own rules and test it.\nIf a new solitaire looks good to you, please, send me its rules(the file you passed to `solkit`) or open an PR and I'll include it into a new release.\nThe built-in set of rules is limited, but you can experiment with different rule combinations and modifications:\n\n- mix of `Free cell` and `Klondike`, or `American Toad` and `Klondike`\n- `Klondike` with fewer or greater number of columns\n- `Klondike` with two decks and 4 foundations with ascending order starting from Ace, and other 4 foundations in descending order starting from King\n- brand new solitaires, like included `Pile'em up`\n- and many more another ways to have fun with solitaires.\n\n### Look and feel\n\nThe application provides two themes. The dark one(default one) that looks like a regular terminal application with black background:\n\n\u003cimg src=\"./images/solkit_dark.png\" alt=\"Dark theme\"\u003e\n\ndark theme with four suit colors enabled:\n\n\u003cimg src=\"./images/solkit_dark_four_colors.png\" alt=\"Dark theme with four suit colors\"\u003e\n\nand Classic theme that looks like a table to play card games with green background:\n\n\u003cimg src=\"./images/solkit_classic.png\" alt=\"Classic theme\"\u003e\n\nThe game is optimized for playing with keyboard, but mouse can be used as well(few terminals still do not support mouse, including new Windows Terminal, but it works in Windows `cmd.exe` terminal).\nKeyboard and mouse controls are describes in details in [user's manual](/docs/usage.md#controls).\n\n## Installation\n\nThe application can be compiled from source, or installed using cargo:\n\n```shell\n$ cargo install solkit\n```\n\nYou need Rust compiler that supports Rust 2018 edition to do it. If you want to upgrade existing `SolKit`, execute the following command:\n\n```shell\n$ cargo install solkit --force\n```\n\n### Pre-compiled binaries\n\nFor Windows and Linux(musl-based build) you can download pre-compiled 64-bit binaries from [Release page](https://github.com/VladimirMarkelov/solkit/releases).\n\n### Portable mode\n\nBy default, `solkit` saves all settings and statistics to user's configuration directory:\n\n- Windows: `%APPDATA%\\rionnag\\solkit`\n- Linux: `~/.config/rionnag/solkit`\n\nIf you create an empty file `config.toml`(or copy it from user's configuration directory) in the same directory where `solkit` executable binary is,\nthe application turns a portable one and since the next launch it will save its settings and your statistics local to the binary.\n\nNote: if you played for a while and want to keep you statistics after making the application portable, do not forget to copy both files:\n\n- `config.toml`: various application settings, including the last played solitaire\n- `stats.toml`: detailed statistics for each played solitaire\n\n## License\n\nMIT or Apache 2.0\n\n## Credits\n\nThank you all who play `Solkit` and send me new solitaires, report bugs, and propose new features.\n\nFeel free to send bugs, suggestions, and pull requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvladimirmarkelov%2Fsolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvladimirmarkelov%2Fsolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvladimirmarkelov%2Fsolkit/lists"}