{"id":13580945,"url":"https://github.com/LinusCDE/chessmarkable","last_synced_at":"2025-04-06T06:32:18.557Z","repository":{"id":48801302,"uuid":"301052646","full_name":"LinusCDE/chessmarkable","owner":"LinusCDE","description":"Chess for the reMarkable using the rust pleco lib","archived":false,"fork":false,"pushed_at":"2022-11-28T00:20:34.000Z","size":339,"stargazers_count":104,"open_issues_count":2,"forks_count":8,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-05T20:46:46.327Z","etag":null,"topics":["pleco","remarkable-tablet","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LinusCDE.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-04T06:08:13.000Z","updated_at":"2024-11-01T20:20:20.000Z","dependencies_parsed_at":"2023-01-23T09:31:22.613Z","dependency_job_id":null,"html_url":"https://github.com/LinusCDE/chessmarkable","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinusCDE%2Fchessmarkable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinusCDE%2Fchessmarkable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinusCDE%2Fchessmarkable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinusCDE%2Fchessmarkable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LinusCDE","download_url":"https://codeload.github.com/LinusCDE/chessmarkable/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247445651,"owners_count":20939952,"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":["pleco","remarkable-tablet","rust"],"created_at":"2024-08-01T15:01:56.639Z","updated_at":"2025-04-06T06:32:18.279Z","avatar_url":"https://github.com/LinusCDE.png","language":"Rust","funding_links":[],"categories":["Rust","Applications"],"sub_categories":["Games"],"readme":"# chessMarkable\n\n[![rm1](https://img.shields.io/badge/rM1-supported-green)](https://remarkable.com/store/remarkable)\n[![rm2](https://img.shields.io/badge/rM2-supported-green)](https://remarkable.com/store/remarkable-2)\n[![opkg](https://img.shields.io/badge/OPKG-chessmarkable-blue)](https://github.com/toltec-dev/toltec)\n[![launchers](https://img.shields.io/badge/Launchers-supported-green)](https://github.com/reHackable/awesome-reMarkable#launchers)\n[![Mentioned in Awesome reMarkable](https://awesome.re/mentioned-badge.svg)](https://github.com/reHackable/awesome-reMarkable)\n\nA chess game for the reMarkable tablet writting using the [pleco](https://crates.io/crates/pleco) chess library which is a port of [Stockfish](https://stockfishchess.org/).\n\n\u003cimg src=\"https://transfer.cosmos-ink.net/SF/mainmenu.png\" width=\"30%\"\u003e\u0026nbsp;\u003cimg src=\"https://transfer.cosmos-ink.net/1tRXA8n/pgnselect.png\" width=\"30%\"\u003e\u0026nbsp;\u003cimg src=\"https://transfer.cosmos-ink.net/LZ9QT/3.jpg\" width=\"30%\"\u003e\n\n## Controlling\nA chess piece can be moved in two ways:\n\n1. Clicking it once and clicking the spot it's supposed to\n2. Clicking it and moving the finger onto the square to move it there on release\n\nThe second method has the advantage that it doesn't highlight the chess piece or shows the possible moves.\n\n## FEN\n\nWhen running the Game with the enviroment variable `RUST_LOG` set to `debug`, the [FEN](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) of a board will be output on each move. This is useful for debugging but also for manually saving a game state or resuming it elsewhere since this notation should be compatible with other chess programs/engines.\n\nWhen starting a game, you'll need to specifiy a slot to play on. On quitting the game, the FEN will get saved to `~/.config/chessmarkable/savestates.yml` which can be used to resume from.\n\n(The `-i` option was removed in favor to add your own fen to the above file).\n\n## PGN Viewer\n\nChessmarkable also includes a PGN Player (huge thanks to [@rmadhwal](https://github.com/rmadhwal), for contributing this feature)!\n\nYou can put downloaded PGN Files into the directory `~/.config/chessmarkable/pgn` on the device with software like scp, FileZilla or WinSCP.\nAfter this, you should be able to browse all the games from the menu point \"PGN Viewer\" and step through all the games.\n\n## Installation\n\n### Prebuilt binary/program\n\n- Go the the [releases page](https://github.com/LinusCDE/chessmarkable/releases)\n- Get the newest released binary file (the one without any extension) and copy it onto your remarkable, using e.g. FileZilla, WinSCP or scp.\n- SSH into your remarkable and mark the file as executable with `chmod +x chess`\n- Stop xochitl (the interface) with `systemctl stop xochitl`\n- Start the game with `./chessmarkable` (or whatever the binary is called now)\n- After you're done, restart xochitl with `systemctl start xochitl`\n\n### Compiling\n\n- Make sure to have rustup and a current toolchain (nightly might be needed)\n- Install the [oecore toolchain](https://remarkablewiki.com/devel/toolchain).\n  - If you're not using linux, you might want to adjust the path in `.cargo/config`\n- Compile it with `cargo build --release`. It should automatically cross-compile.\n\n## Todo\n\n- Proper own icon(s)\n- Clean the code\n\n## reMarkable 2 support\n\nThis app cant actually drive the rM 2 framebuffer. It needs [rm2fb](https://github.com/ddvk/remarkable2-framebuffer/) for that.\n\nIf you execute chessmarkable from ssh, be sure to have followed rm2fb steps to enable the support. When installed running `rm2fb-client ./chessmarkable` should work as well. Launching through a launcher (from toltec) should just work.\n\n## Credit\n\n- The [pleco](https://crates.io/crates/pleco) library is used as the engine, checking valid moves and providing the bots\n- The chess pices are from [pixabay here](https://pixabay.com/vectors/chess-pieces-set-symbols-game-26774/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLinusCDE%2Fchessmarkable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLinusCDE%2Fchessmarkable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLinusCDE%2Fchessmarkable/lists"}