tamatool - GitLite

KO | EN

gitlite — search

#javascript #python #ai #typescript #llm #android #macos #awesome #cli #vue #pytorch #security #ios #openai

tamatool

(★ 201)

A Cross-Platform Explorer for First-Gen Tamagotchi

파일 탐색기

최종 버전 다운로드 (.zip)

- Makefile
- source-1024x1024.png
- Makefile
- tamatool.desktop
- tamatool.png
- - icon_128x128.png
  - icon_128x128@2x.png
  - icon_16x16.png
  - icon_16x16@2x.png
  - icon_256x256.png
  - icon_256x256@2x.png
  - icon_32x32.png
  - icon_32x32@2x.png
  - icon_512x512.png
  - icon_512x512@2x.png
- Info.plist
- Makefile
- tamatool.mac
- angel-background-original.jpg
- p1-background-original.jpg
- p2-background-original.jpg
- screenshot.png
- screenshot2.png
- angel-background.png
- angel-icons.png
- p1-background.png
- p1-icons.png
- p2-background.png
- p2-icons.png
- shell.png
- common.mk
- hal_types.h
- image.c
- image.h
- lib
- mem_edit.c
- mem_edit.h
- program.c
- program.h
- state.c
- state.h
- tamatool.c
- Makefile
- tamatool.exe.manifest
- tamatool.ico
- tamatool.rc
.gitignore
.gitmodules
LICENSE
Makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/jcrona/tamatool

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd tamatool

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://github.com/jcrona/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 !

![TamaTool](https://raw.githubusercontent.com/jcrona/tamatool/master/misc/screenshot.png)![TamaTool-Shell](https://raw.githubusercontent.com/jcrona/tamatool/master/misc/screenshot2.png)

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 __<rom_basename>_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](https://siliconpr0n.org/map/bandai/tamagotchi-v1/) (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