Skip to content

Latest commit

 

History

History
85 lines (46 loc) · 5.82 KB

README.md

File metadata and controls

85 lines (46 loc) · 5.82 KB

PocketPuzzles

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

More screenshots

Download the app here

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, sgt-puzzles-aho-extensions, 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 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 (see note 2 below)
  • PB1040 - InkPad X
  • PB626 - Touch Lux 3 (see note below)
  • PB628 - Touch Lux 5 (see note below)
  • PB743 - InkPad Color 3 (see notes below)

The app seems to work also on Vivlio devices, for further details see this blog entry (in french language)

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.

Also note The app doesn't use color mode and the code was modified to substitute colors with greyscale and textures; color devices will run in greyscale mode (usually higher resolution than color)

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 ready to install

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

Memory usage: The app itself is around 1.5 MB. It additionally stores the game preferences and the status of the last played game in a separate configuration file, which is usually less than 100 KB. So in total the app will take the space of a few eBooks.

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, or make -j4 to compile parallel using 4 processor cores (adjust according to your machine).

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

Changelog after Beta release 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, Asher Gordon, Didi Kohen, and Anders Holst.

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.