/PocketPuzzles

Port of Simon Tatham's Portable Puzzle Collection to the PocketBook eReader platform

Primary LanguageCOtherNOASSERTION

PocketPuzzles

Port of Simon Tatham's Portable Puzzle Collection to the PocketBook eReader family

More screenshots

Inspired by and building on the work of Port to Android by Chris Boyle and Puzzles for pocketbook by mnk

To get a mostly complete collection for all puzzles ever written for the SGT puzzles, I'm planning to also include unofficial puzzles and puzzle variations from puzzles-unreleased and sgtpuzzles-extended.

The unfinished puzzles from the official collection (Group, Slide, Sokoban) will not be included.

Compatibility

Tested only on the PocketBook Touch HD 3, because that is the device I own. Should principally work on all devices with firmware 5 or higher.

I received reports that the app works with these devices:

  • PB632 - Touch HD 3
  • PB631 - Touch HD / Touch HD 2
  • PB740 - InkPad 3
  • PB633 - Pocketbook Color
  • PB1040 - InkPad X
  • PB626 - Touch Lux 3 (see note below)
  • PB628 - Touch Lux 5 (see note below)

Please note The app is developed for a device with screen resolution of 1072 x 1448 pixels. The app should be scaling according to the available resolution, but might have issues displaying certain UI elements on devices with a different resolution.

I'm interested in reports from more devices; especially how it looks like on color screen and on devices with screen resolution different than the Touch HD 3. When submitting an issue, please provide relevant screenshots.

Binary app

See here release/README.md for already compiled app files ready for installation on a PocketBook Firmware 5 and higher device.

Manual build

Clone the pocketbook SDK and set it up for the firmware of your device.

Modify the path to your local copy of the SDK in the Makefile at the line PBSDK ?= ...

Run: make

When everything compiles successfully, you find build/SGTPuzzles.app. Copy this to the folder /applications on your device. Reboot if necessary after transfer.

Development history

See ChangeLog.md

14.11.2020 Beta version ready! Games can now be individually configured. All elements needed for beta are now implemented.

6.10.2020 Alpha version ready! Persistence of game params and current game now working. Most games UI are reworked suitable for eInk screen.

16.8.2020 Next milestone Game control buttons now working. All games playable (but those using blitter / animations still need rewriting)

11.8.2020 First major milestone reached! Some games are now playable on a very basic level.

There is still work to do. See ToDo list below. eInk screens are limited in response time and color availability, so most of the games need individual tweaking to make them fun to play.

See ToDo.md

MIT License

See LICENSE

This project is using work released unter a MIT license by Simon Tatham, Chris Boyle, Richard Boulton, James Harvey, Mike Pinna, Jonas Kölker, Dariusz Olszewski, Michael Schierl, Lambros Lambrou, Bernd Schmidt, Steffen Bauer, Lennard Sprong, Rogier Goossens, Michael Quevillon, Phil Tunstall, and Didi Kohen.

Important Note!

Lots of hacking and reverse-engineering, as documentation for PocketBook app development is very, very sparse.

Build and installation is completely on your own risk! You must be aware that this software could brick your device.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.