MCPcopy Create free account
hub / github.com/TailsmanDesign/PocketMage_PDA

github.com/TailsmanDesign/PocketMage_PDA @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
487 symbols 1,485 edges 78 files 136 documented · 28% updated 2d agoBETA_V1.8.3 · 2026-05-25★ 1,94829 open issues

Browse by type

Functions 432 Types & classes 55
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PocketMage PDA

PocketMage is Pre-Launch on Crowd Supply! Check it out here!

@Ashtf 2025

Screenshot 2025-09-10 203805

Screenshot 2025-09-10 203851

[Project Summary]

This project is a PDA powered by an ESP32-S3 running a custom OS written in C++ using PlatformIO. This project utilizes an E-Ink and OLED screen in tandem to mitigate the refresh rate restrictions of an E-Ink panel while retaining the aesthetics and benefits of using E-Ink. This project is a work in progress and currently amounts to a simple GUI for navigating between apps, a text (.txt) file editor, and a basic file manager. More applications are planned for the future and a list of TO-DOs can be found below.

At this point, the plan for this project is to get the software and hardware to maturity and once a finished product is achieved, a few things will happen. First, the project files (Code, KiCad schematics, 3D files) will be open-sourced and free for anyone to access. Next, I will likely begin selling kits that allow people to purchase all the parts required to build a device for themselves if they don't want to source the parts themselves. Finally, the community will be encouraged to help develop the software for the device and hopefully push it even further than I could myself.

I will try my best to keep this GitHub up to date with the development of the device.

[Getting Started]

Helpful Resources:

FAQ

Tutorials

PocketMage Command & Keystroke Manual

3rd Party App Template

Check the APP_TEMPLATE.cpp and /Code/PocketMage_V3/src/readme.md file for more information. Check out the following video as a tutorial on how to create and format your app: Developing For the PocketMage

[Hardware]

  • ESP32-S3 WROOM1 with 16mb flash and 8mb RAM. WiFi and Bluetooth supported.
  • 3.1" 320x240px 1-bit SPI Eink panel (GDEQ031T10) with integrated driver
  • 256x32px 1-bit SPI OLED (SSD1326, ER-OLED018-1W) with integrated driver
  • MicroSD card slot with support for up to 2TB
  • TCA8418 I2C Keyboard Matrix IC
  • Piezo Buzzer (Simple Tones)
  • Power Button
  • 1200mAh pouch-style LiPo battery with JST PH (2mm) connector
  • USB Type-C connector
  • PCF8563T I2C RTC (Real Time Clock) module
  • Expansion port with the following breakouts:
    • +3.3v
    • GND
    • I2C SDA
    • I2C SCL
    • SPI MOSI
    • SPI SCK
    • SPI MISO
    • GPIO A
    • GPIO B
    • GPIO C
    • GPIO D / UART TX (changeable with solder jumper, default TX)
    • GPIO E / UART RX (changeable with solder jumper, default RX)

[Software]

  • Text editor app
  • FileWizard file-management app
  • Calendar app
  • USB file transfer app
  • Settings app
  • Tasks app
  • Journal app
  • Dictionary app (Lexicon)
  • Basic commands supported through the home menu:
    • roll dN (dice roll, N=number of sides)
    • set time and date
    • directly open files in Notes or FileWiz by typing the name
    • etc.

[Planned Features]

  • Timers and alarms
  • E-book reader
  • WiFi notes/calendar sync (Google Docs/Calendar)
  • LoRa/Meshtastic add-on module
  • Battery expansion add-on module
  • Custom abbreviations
  • Bluetooth keyboard support

License

All files are distributed under Apache-2.0 license:

PocketMage PDA - A clamshell note-taking and productivity device using E-Ink and OLED.

License

Core symbols most depended-on inside this repo

Shape

Function 281
Method 151
Class 35
Enum 20

Languages

C++98%
Python2%

Modules by API surface

Code/PocketMage_V3/src/OS_APPS/TERMINAL.cpp51 symbols
Code/PocketMage_V3/src/OS_APPS/TXT.cpp44 symbols
Code/PocketMage_V3/lib/PocketMage/include/pocketmage_sd.h32 symbols
Code/PocketMage_V3/src/OS_APPS/CALENDAR.cpp26 symbols
Code/PocketMage_V3/src/OS_APPS/APPLOADER.cpp24 symbols
Code/PocketMage_V3/lib/PocketMage/src/pocketmage_kb.cpp24 symbols
Code/PocketMage_V3/lib/PocketMage/src/pocketmage_sd.cpp20 symbols
Code/PocketMage_V3/lib/PocketMage/src/frames.cpp19 symbols
Code/PocketMage_V3/lib/PocketMage/src/MP2722.cpp18 symbols
Code/PocketMage_V3/lib/PocketMage/include/frames.h18 symbols
Code/PocketMage_V3/lib/PocketMage/src/pocketmage_eink.cpp15 symbols
Code/PocketMage_V3/src/OS_APPS/COMM.cpp14 symbols

For agents

$ claude mcp add PocketMage_PDA \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page