Principia Discardia

dslibris – Samchillian – Ray Haleblian

dslibris: an ebook reader for the Nintendo DS

dslibris is a back-to-basics homebrew book reader for the DS, DS Lite, and DSi. Its main idea is to provide a comfortable and uncluttered reading experience.


Sample book page


  • antialiased, proportional text
  • UTF-8, so a wide range of languages are honoured
  • auto-scan for books stored on your media
  • power-save upon closing the DS lid
  • restoration of previous page on restart
  • brightness control on DS Lites
  • support for adding TrueType and OpenType fonts

dslibris supports EPUB format files encoded in UTF-8. Calibre is a powerful tool for converting a plethora of formats, including PDF, to EPUB. See the book preparation postings on Sourceforge for other methods for format conversion.

This being DS homebrew, you’ll require a media card for your DS, and you will need to DLDI patch dslibris.nds for your DS media device.

The latest news, release downloads, and source are available on Sourceforge. Also check there for release notes, to find or post known issues or feature requests, or get help.



98 thoughts on “dslibris: an ebook reader for the Nintendo DS

  1. Hey, I’m opening up a homebrew site, with links and other stuff and eBooks in .xhtml. I was wondering if its ok to make a page dedicated to dslibris? The page on my site would have my homebrew video review of dslibris, along with a description for the app, a link to your site and I would give credit to you for making the program. Please tell me what you think!

  2. I’ll give you the page so you can take a look at it, its a flash page not html.

  3. Excellent work. Reading a well-formatted xhtml sideways feels like, and is convenient as reading a real book.
    It is well worth the little effort of converting the files to xhtml.

  4. How does Tom use OpenOffice to convert PDF’s? What program can even open a PDF with OOO? With Writer, it only outputs junk (You can create PDFs with OOO writer, but can’t open PDFs) . Also, there’s a bunch of ‘Freeware’ products out there that only let you convert the first 3 pdf pages. PDFtoHTML has no useful documentation for installing. ./make ./configure….blah, blah. Where’s the INSTALL.readme?

    Yes, and then there’s the PDF picture…scan it with OCR, and then convert it to XHTML. Uh, Terrasect, SimpleOCR, blah.


  5. I’m still not finding anything for converting pdf to xhtml. I’m on a windows machine that I use with my flash cart, but I do have an old powerbook with Tiger on it if need be. What can I use?

  6. Nick and Anon, i am skeptical that much PDF can be translated into a form that will work. The limitation is in the PDF format, which presupposes a certain page size when it is laid out and throws away paragraph information in the process.*

    The exception may be tagged PDF, which can be reflowed. I have not done a full test of tagging a PDF and running pdftohtml on it. If somebody has some experience with tagged PDF, you could try and see what you can come up with and share it. OS X users can get pdftohtml via Fink as package … lessee … ‘poppler-bin’. Fedora users should look in apt. Surely a Windows version is out there too.

    I’ll post to the SF list if I find out any solution for this.

    * viewing PDF on a mobile browser or in Reader for WIndows CE/Mobile is illustrative. There’s a lot of panning and zooming involved.

  7. I managed to find a copy of some books in lit format, then converted them with .. ConvertLit, then AbiWord into xhtml. It works now. I’d really love a more full-featured bookmark system.

  8. besides brandon’s MOON PROJECT site… does any one know a site where i can find other ebooks available to add onto my NDSL?

    Thanks in advance! (^_^)

    . the staCius .

  9. @demonman: 98% of the time, TXT format is preformatted for a certain screen width assuming some fixed width font. The assumed screen width is never the width of a DS screen. TXT content can’t be reflowed into a DS-sized screen with any reliability.

  10. Love your program! Converting books can be a pain sometimes (abiword has been my best success) but it’s worth it. I only ask that maybe you put a ‘forward/back 10 pages’ kind of feature (maybe up and down?)

  11. @BlueZoidberg: fast page flipping is in the upcoming 1.3 release.

    The project has multiple developers now, they monitor the bug and feature request lists on SourceForge, so folks can post their ideas there.

    Thanks to everybody for their comments.

  12. I converted some books to .htm .. they didnt work. do they HAVE to be “xhtml” and what conversion prgram can i use and where to find it so i can do just that.

    thanks in advance!

    . the staCius .

  13. Hi, I like your program alot, but no matter how many files I have on my sd card, I am unable to get more than 30 books to show up in my library. Am I doing something wrong? or is there some sort of limit?

  14. Tepkel, it’s not you, it’s dslibris. There is a limit on number of books. We’re going to look at removing that restriction in a future 1.3 release.

  15. By the way, the Hebrew is all backwards. For example, in English it would look like “olleH dlrow” for “Hello world.”

  16. Is it possible to launch dslibris from another directory but the root one?
    (e.g. using it as moonshell for CycloDS Evolution?)

  17. Cool Packages… i just got a question to ask.. where is the best place to get e-books to upload on my ds?

  18. Thanks a lot for this great program, I use it all the time! I like how simple and convenient it is. I’ve seen it requested by other people, but I would LOVE it if dslibris was capable of recognizing more than 6 book files at a time–I’d love to be able to scroll through all the book files on my ds.
    Thanks again!

  19. @raistlin: Possibly, but I can’t test right now, no DS.
    @rose: The latest version now supports a lot more than 6 books, there should be prev/next buttons on the browser screen.

  20. Just another vote for .txt support here, as by the time I’ve gone through the inevitably problematic conversions of one of my e-books I’ve lost the desire to read it. DSLibris seems like a great piece of homebrew otherwise, I enjoyed the books I did have the patience to convert (& troubleshoot)! Would LOVE a good .txt reader instead of being stuck with Moonshell as the “best” (ha!).

  21. Hello Ray, this awesome project has been in hiatus for a while. I hope it’s not been discontinued. 😦

  22. @Pulstar: hello again. It’s still barely alive, but I’ve been without my hardware and there have been performance issues recently due to code changes, yada yada.

  23. I’m glad to hear you’re still working on it at all 🙂 Homebrew for the DS has certainly slowed down but your app remains my #1 favourite. I’ve read dozens of ebooks using it. It already has most of the features people want but things like auto shut-off and 8-bit colour palettes would bring it closer to perfection! 😉

    Best regards!

  24. Can’t you somehow figure out how to use dslibris to read .lit files? All this extra bs I have to go though to figure this out simply isn’t worth it.

  25. After I realized that Open Office converts files into xhtml pretty painlessly, DSLibris became one of my most-used apps! Are there continued plans for development or was 1.3 the last release that can be expected? Thanks again for letting me carry one less device!

  26. @Meghan: great, one more point for OpenOffice!
    @Annoyed: annoying, isn’t it? Microsoft provides tools for creating LIT files but not for decoding them, at least not for people without a special arrangement with them, perhaps.

  27. :: Gives OpenOffice a shot :: (Disclaimer: I love the idea of your application, I’m just not as tech savy as many others are. I do try though.) ❤ U

  28. hi
    if the first ebook you install is a massive English dictionary,
    how does this affect the number of ebooks you can fit into ram? can it not be used for compression of other ebooks?

    When I open the homebrew , it loads for a while then it shows:

    $ dslibris
    fatal: no filesystem.
    info: DLDI patch?

    (is shows in green font color) PLEASE HELP ? thanks.

  30. Ohhoyea…i wanted to do homebrew, but then i bought a 3ds. i have no idea if nds roms etc.’s post is good for us 3ds users or not. is it?

  31. Ok, this is a longshot, considering the last post is two years old… but I’m having a problem and I need help. After it loads the books I get this error:

    terminate called after throwing an instance of ‘st9bad_alloc’
    what (): std: bad_alloc

    Any ideas?

Comments are closed.

%d bloggers like this: