dslibris/README.md
2025-04-06 15:26:03 -04:00

1.7 KiB

C/C++ CI

Herein lies the source code for dslibris, an EPUB ebook reader for the Nintendo DS, DSi and DSi XL.

Browser

Quickstart

A sample page

Releases

Download the zip file in the Releases section.

Installation

See INSTALL.txt or the Quickstart page in the Wiki.

Development

Prerequisites

We use devkitPro's toolchain for ARM, aka devkitARM.

Development is biased towards Debian-clan (eg Ubuntu) as a platform. You should also get far with macOS. CentOS and msys2 have also worked, but haven't been checked recently. Ubuntu under WSL would work too, but you'll be missing mount support for emulator testing.

Some configuration exists for using Visual Studio Code.

Once dkp-pacman is installed, can get needed packages via

sudo dkp-pacman -S $(cat requirements.txt)

Building

To build the program, assure devkitARM is available to your shell:

. activate

then

make

dslibris.nds should show up in the top directory.

DLDI

If your media does not auto-patch DLDI, .dldi for a few specific cases (R4, CycloDS Evolution, MPCF) are here:

etc/dldi

used like e.g.

dlditool etc/dldi/r4_v2.dldi dslibris.nds

Debugging

Copy your build to a DS and maybe Log() messages. Good luck.

See Also

Blog: http://ray.haleblian.com/wordpress/dslibris-an-ebook-reader-for-the-nintendo-ds/

Development Tools: http://devkitpro.org

EPUB/W3C/IDPF: http://idpf.org