---
title: 'Scriptorium BBS'
url: 'https://wiki.teletypegames.org/services/bbs/scriptorium-bbs'
markdown: 'https://wiki.teletypegames.org/services/bbs/scriptorium-bbs.md'
lang: en
date: '2026-11-01'
description: 'The library of the BBS network: thousands of public-domain books from Project Gutenberg, cut into pageable chapters for a modern terminal or a Commodore 64. Live at teletypegames.org:2330, in the browser on bbsweb, and through TTG Gate BBS Overview A Ruby app on the rubbs gem, like the Teletype B…'
taxonomy:
  tag:
    - howto
    - bbs
    - rubbs
    - books
---

# Scriptorium BBS

> The library of the BBS network: thousands of public-domain books from Project Gutenberg, cut into pageable chapters for a modern terminal or a Commodore 64.
> 
> **Live at `teletypegames.org:2330`**, in the browser on [bbsweb](https://bbsweb.teletypegames.org), and through [TTG Gate BBS](https://wiki.teletypegames.org/services/bbs/ttg-gate-bbs)

# Overview

A Ruby app on the [**rubbs**](https://git.teletypegames.org/engines/rubbs) gem, like the [Teletype BBS](https://wiki.teletypegames.org/services/bbs/teletype-bbs), [Alexandria BBS](https://wiki.teletypegames.org/services/bbs/alexandria-bbs) and [Commodex BBS](https://wiki.teletypegames.org/services/bbs/commodex-bbs).

It has two faces on one port:

- **Modern**: ANSI colours, windows, menus and the mouse (SyncTERM, NetRunner, PuTTY, bbsweb). Shelves, books and chapters in two-pane windows, and a reader window that wraps the chapter to its width.
- **Commodore 64**: PETSCII on a 40×25 screen, for a C64 terminal program (CCGMS, Novaterm, UltimateTerm) behind a WiFi modem. A one-key menu, numbered lists, and 38-column pages that wait for RETURN.

A call starts with rubbs' `Rubbs::Common::Call::Terminal` question: RETURN takes the guess, `1` picks the modern face, `2` the C64.

# The books

- **The catalog** is Project Gutenberg's own, `pg_catalog.csv.gz` (about 78,000 texts and 400 bookshelves). The board imports it into SQLite with a full-text index on titles and authors and reads it again every week; the old catalog serves until the new one is ready. Every search word matches as a word prefix, accents do not matter (`bronte` finds Brontë), and `lang:fr` keeps one language.
- **The Classics shelf** is the board's own pick of 36 well-known books (`config/classics.yml`); it works even before the first catalog import.
- **A book's text** is fetched from gutenberg.org when someone first opens it, cleaned (the Project Gutenberg header and footer off, prose lines joined into paragraphs) and cut into chapters by its headings (CHAPTER, BOOK, PART, ACT, STAVE, LETTER, CANTO, roman numerals…), skipping the table of contents. A very long chapter is split into parts; a book with no headings into sections of about 16 KB. The cleaned text and its chapter index stay in a disk cache (300 MB, least recently read out first), and only the chapter on the screen is read into memory.
- **Most read** counts the books opened on this board, once per call.

Every book page credits it: *eBook #N from Project Gutenberg, gutenberg.org/ebooks/N — public domain in the USA.*

# Reading

**On a modern terminal:**

| Key | Action |
|---|---|
| F2 | The Classics shelf |
| F3 | Search by title or author |
| F4 | Project Gutenberg's bookshelves |
| F7 | Most read on this board |
| Enter or Alt-R | Open a book / read a chapter |
| PgUp, PgDn, Home, End | Page in the reader |
| ← → or P, N | Previous / next chapter |
| F5 or Alt-Enter | Full screen and back |
| Alt-X | Log off |

**On a Commodore 64** the menu has `1` the Classics, `2` the bookshelves, `3` search, `4` most read, `A` about, `Q` log off. A book has an info page and a numbered chapter list; in the reader RETURN gives the next page (and at the end the next chapter), `B` goes back a page, `N`/`P` change chapter, `Q` goes back to the list. Curly quotes, dashes and accented letters are turned into what a C64 can show.

# Configuration and data

| Variable | Default |  |
|---|---|---|
| `SCRIPTORIUM_BBS_MIRROR` | `https://www.gutenberg.org` | where the texts come from; a mirror works too |
| `SCRIPTORIUM_BBS_CATALOG_URL` | `https://www.gutenberg.org/cache/epub/feeds/pg_catalog.csv.gz` | the catalog |
| `SCRIPTORIUM_BBS_CATALOG_TTL` | `7` | days before the catalog is read again |
| `SCRIPTORIUM_BBS_CLASSICS` | `config/classics.yml` | the Classics shelf |
| `SCRIPTORIUM_BBS_DB` | `data/catalog.sqlite3` | the imported catalog |
| `SCRIPTORIUM_BBS_CATALOG_FILE` | `data/pg_catalog.csv.gz` | the downloaded catalog |
| `SCRIPTORIUM_BBS_TEXTS` | `data/texts` | the text cache |
| `SCRIPTORIUM_BBS_CACHE_MB` | `300` | the text cache's size |
| `SCRIPTORIUM_BBS_BOOK_MAX` | `8388608` | the largest book fetched, in bytes |
| `SCRIPTORIUM_BBS_READS` | `data/reads.jsonl` | the reads, one JSON line each |

The board has no secrets. After a change to the chapter rules, clear `data/texts` so the cached books are cut again.

# Under the hood

**Badges.** With an account this board counts for Bookworm (1, 10, 50 books opened), besides the network's own.

It runs as `boards/scriptorium` of [`bbs/ttg-bbs`](https://git.teletypegames.org/bbs/ttg-bbs), in the shared `ttg-bbs` container; its data is in `/srv/stacks/ttg-bbs/boards/scriptorium/data` and stays between deploys. A push to master of `bbs/ttg-bbs` deploys it from Woodpecker (`ci-deploy ttg-bbs`); a change only in `boards/scriptorium` restarts only this board. Its log lines are in `docker logs ttg-bbs`, with `"board":"scriptorium-bbs"`.

The code follows the house layering: `lib/domain` (the book, shelf, chapter and text models; the Gutenberg, catalog, classics, read and text-cache repositories; `ChapterService`, `LibraryService`, `ReadingService`; the composition root `ScriptoriumBBS`) knows nothing of telnet, and `lib/ui` holds `UI::Modern` with its `ReaderWindow` and `UI::Petscii`. A book is fetched and cut one at a time, so a burst of new books cannot blow the memory limit.

 [howto](https://wiki.teletypegames.org/tags?tag=howto)[bbs](https://wiki.teletypegames.org/tags?tag=bbs)[rubbs](https://wiki.teletypegames.org/tags?tag=rubbs)[books](https://wiki.teletypegames.org/tags?tag=books) 

## Related pages

- [BBS boards](https://wiki.teletypegames.org/services/bbs) Services
- [Siliconia BBS](https://wiki.teletypegames.org/services/bbs/siliconia-bbs) BBS boardsThe computer and console museum on a telnet line: every machine Wikidata knows, Wikipedia's stories, and the callers' marks and memories
- [Kinema BBS](https://wiki.teletypegames.org/services/bbs/kinema-bbs) BBS boardsThe film catalog on a telnet line: any film or person from Wikidata, Wikipedia's articles, and the callers' ratings and watchlists
- [Monitor BBS](https://wiki.teletypegames.org/services/bbs/monitor-bbs) BBS boardsGrafana's dashboards on a telnet line, for the accounts with the grafana role, through TTG Gate BBS only
- [TTG Mail BBS](https://wiki.teletypegames.org/services/bbs/ttg-mail-bbs) BBS boardsThe mail of the BBS network on a telnet line: letters between the accounts, read, answered and written on either face, plus the board's wall and a word to the sysops

'; var prevLevel = 2; for (var i = 0; i < headings.length; i++) { var h = headings\[i\]; var text = h.textContent.trim(); var slug = text.toLowerCase() .replace(/\[áàâä\]/g,'a').replace(/\[éèêë\]/g,'e').replace(/\[íìîï\]/g,'i') .replace(/\[óòôöő\]/g,'o').replace(/\[úùûüű\]/g,'u') .replace(/\[^a-z0-9\]+/g, '-').replace(/^-|-$/g, ''); if (!slug) slug = 'heading-' + i; if (used\[slug\]) { slug += '-' + i; } used\[slug\] = true; h.id = slug; var level = parseInt(h.tagName.charAt(1)); var cls = level > 2 ? ' class="toc-child"' : ''; html += '- [' + text + '](#'%20+%20slug%20+%20')
'; } html += '
'; toc.innerHTML = html; // Scroll-spy: highlight current heading var links = toc.querySelectorAll('a'); var ids = \[\]; for (var j = 0; j < links.length; j++) ids.push(links\[j\].getAttribute('href').slice(1)); function updateActive() { var current = ''; for (var k = 0; k < ids.length; k++) { var el = document.getElementById(ids\[k\]); if (el && el.getBoundingClientRect().top <= 80) current = ids\[k\]; } for (var m = 0; m < links.length; m++) { links\[m\].parentNode.classList.toggle('active', links\[m\].getAttribute('href') === '#' + current); } } window.addEventListener('scroll', updateActive, { passive: true }); updateActive(); })();

---

## Navigation

- Parent: [BBS boards](https://wiki.teletypegames.org/services/bbs.md)
- Previous: [Pixelia BBS](https://wiki.teletypegames.org/services/bbs/pixelia-bbs.md)
- Next: [Siliconia BBS](https://wiki.teletypegames.org/services/bbs/siliconia-bbs.md)
