71 lines
3.0 KiB
Markdown
71 lines
3.0 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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`.
|