RexiMemo-OSE/readme.md

Hatena server — Python 3 port

This is a replacement server for the discontinued Flipnote Hatena service used by Flipnote Studio on Nintendo DSi.

This repository has been ported from its original Python 2.7 implementation to Python 3. The server protocol, URL layout, plaintext database, bundled Hatena resources, PPM/TMB handling, UGO handling, and NTFT handling are retained.

Requirements

• Python 3.9 or newer (the port is tested with Python 3.13)
• Twisted
• NumPy
• Pillow
• ffmpeg only if you want to use the optional PPM-to-MKV export command

Install Python dependencies with:

python3 -m pip install -r requirements.txt

Authentication server

Hatena Server also requires a compatible authentication server for Flipnote Studio authentication. This server does not provide the external authentication service by itself.

Possible authentication services include:

• Sudomemo's authentication service — this may work for personal hardware testing, but its use is not recommended for emulators or for a publicly released/server deployment. Always check and follow Sudomemo's current rules and terms before using their infrastructure; do not rely on their service for a deployment they do not permit.
• Reximemo's authentication service — this may be used as an alternative if it is currently running/available.

Whichever service you use, configure the server/client setup so Flipnote Studio can complete authentication before attempting to use the Hatena replacement.

Run the server

From the repository root:

python3 server.py

The server listens on TCP port 8080 by default, matching the original project. Point the DSi proxy settings at the machine running this server, port 8080, then open Flipnote Studio.

The server accepts the absolute-form HTTP request targets normally sent by a proxy client and restricts normal Hatena routes to requests carrying the DSi session header, as the original implementation did.

Hatenatools utilities

The bundled format utilities are Python 3 compatible:

python3 Hatenatools/PPM.py
python3 Hatenatools/UGO.py
python3 Hatenatools/NTFT.py

PPM/TMB parsing, thumbnails, frame decoding, sound decoding, UGO packing/parsing, and NTFT packing/parsing use bytes explicitly under Python 3. The PPM sound decoder no longer depends on the removed audioop standard-library module, so it works on Python 3.13+.

Tests

Run the included smoke/regression suite with:

python3 -m unittest discover -s tests -v

The tests use the original repository's bundled sample Flipnote and NTFT/UGO assets. The server resource-tree smoke test can run even when Twisted is not installed by using a minimal test-only stub; running the actual server still requires Twisted.

Notes

The database remains the original single-process plaintext backend. Its files live under database/, and uploaded Flipnotes are written under database/Creators/<creator-id>/.

The original project and Hatenatools licensing files are retained. See license.md and Hatenatools/License.txt.