百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
T

tamatool

> 编程语言
开源

第一代 Tamagotchi 的跨平台浏览器

198 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

第一代 Tamagotchi 的跨平台浏览器

TamaTool - A Cross-Platform Explorer for First-Gen Tamagotchi

Synopsis

TamaTool is a cross-platform explorer for first-gen Tamagotchi (like P1, P2 and Angel) relying on the hardware agnostic first-gen Tamagotchi emulation library TamaLIB, and mainly targeting Linux, Windows and MacOS.

More than a simple emulator, it is an exploration tool featuring a realtime RAM editor, an ASM debugger, an I/Os monitor and a sprite manipulator, allowing to play around with E0C6S46/8 based Tamagotchi ROMs. It also allows to save and restore its emulation state, thus allowing you to backup and share your best friend !

In order to create the background images used in TamaTool, I scanned the background of my own P1, P2 and Angel, that I filtered/enhanced using GIMP. The original scans can be found in the misc folder. The shell is also a photo of my P1.

Notes regarding the supported platforms

The Windows build does not include the realtime memory editor. The ASM debugger and I/Os monitor do work, but the emulation is very slow when they are enabled because of the poor console performances. Android support would be feasible, but a native implementation of TamaLIB without libSDL2 would probably be more efficient.

Build instruction

First, you need to clone TamaTool and its submodule:

$ git clone --recursive https://github.com/jcrona/tamatool.git

Then the instructions depend on the targetted platform.

Linux (or other Unix environments providing the dependencies as system libraries)

TamaTool depends on libSDL2, libSDL2-image and libpng. On Ubuntu, you can install those libraries using the following command:

$ sudo apt-get install libsdl2-dev libsdl2-image-dev libpng-dev

Then you can build a distribution package (no library bundled) with:

$ make linux

The package will be available in the linux folder.

Windows

Only cross-compiling from linux using MinGW64 is supported. The required dependencies are provided as prebuilt binaries. On Ubuntu you can install MinGW64 using the following command:

$ sudo apt install gcc-mingw-w64

Then you can build a distribution package (with the required libraries bundled) with:

$ make windows

The package will be available in the windows folder.

MacOS

TamaTool needs to be built on MacOS. The required dependencies are provided as prebuilt binaries. You can build a distribution package (with the required libraries bundled) with:

$ make mac

The package will be available in the mac folder.

Usage

TamaTool being an emulator, it requires a compatible Tamagotchi ROM called rom.bin in its folder. This ROM is not provided here. For your information, the expected ROM format is 16 bits in big-endian per instruction (the actual E0C6S46 instructions are 12-bit long).

Hatching a new Tamagotchi:

$ ./tamatool

Using a specific ROM:

$ ./tamatool -r some_path/my_rom.bin

Starting the memory editor:

$ ./tamatool -e

Looking at the CPU instructions in realtime:

$ ./tamatool -c

Extracting the data from the ROM to a PNG file:

$ ./tamatool -E data.png

Importing back the data into the ROM:

$ ./tamatool -M data.png

When playing around with the extracted data, you can safely modify the sprites. However, modifying other data will likely result in a broken ROM.

Getting all the supported options:

$ ./tamatool -h

Once running, you can either click on the shell buttons to interact with the Tamagotchi, or you can press the left, down and right arrow keys of your keyboard.
Pressing SPACE or clicking on the screen triggers the vibration sensor (the Angel has one for instance)
Pressing s puts the emulation in step by step mode and executes the next instruction, while r resumes it.
Pressing w fully executes the next instruction or call (no step by step inside a call).
Pressing x stops the execution right after the next call.
Pressing c stops the execution right after the next return.
Pressing f toggles between the original speed, x10 speed and unlimited speed.
Pressing t shows/hides the shell of the Tamagotchi.
Pressing i increases the size of the GUI, while d decreases it.
Pressing b saves the emulation state to a _saveN.bin file, while n loads the last saved state.

License

TamaTool is distributed under the GPLv2 license. See the LICENSE file for more information.

Hardware information

The Tamagotchi P1 and P2 are based on an E0C6S46 Epson MCU, and runs at 32,768 kHz, while the Tamagotchi Angel, Umino (Ocean), Morino (Forest), Mothra, Tamaotch and Genjintch are based on an E0C6S48 Epson MCU running at 32,768 kHz and 1 MHz. Their LCDs are all 32x16 B/W pixels, with 8 icons. To my knowledge, the P1 ROM available online has been extracted from a high-res picture of a die. The ROM mask was clear enough to be optically read. The pictures can be seen there (thx asterick for the link!).
I would love to see the same work done on a P2 and add support for it in TamaLIB/TamaTool! Someone did the same job for the P2 and other first-gen devices!

__
Copyright (C) 2025 Jean-Christophe Rona

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言