Download these first:

1. TI Connect CE (Windows or Mac):
   https://education.ti.com/en/products/computer-software/ti-connect-ce-sw

2. CE calculator libraries (clibs):
   A copy is already included as clibs.8xg. You do not need to download it again.
   Original download: https://github.com/CE-Programming/libraries/releases/tag/v15.0

3. Only if your calculator has OS 5.5 through 5.8.4: arTIfiCE v2.1:
   https://yvantt.github.io/arTIfiCE/
   Get arTIfiCE_v2.1.8xp. It appears as A on the calculator.
   This version does not need Cabri Jr. or another calculator app.

If your calculator has OS 5.0 through 5.4, including 5.1.5, skip arTIfiCE.
Find your OS: press 2nd, then +, then choose About. Keep your current OS.
OS 5.8.5 needs a different arTIfiCE version and has not been tested with CEreader.
Use its official instructions; this guide covers tested versions through 5.8.4.

LINUX: TI Connect CE is not available for Linux. Use WebTILP instead:
https://web.tilp.info/
It needs a supported browser and USB access. Physical Linux USB transfer has
not been tested here. Follow WebTILP's own connection instructions.

Get the reader onto your calculator:

1. Extract the WHOLE download. On Windows choose Extract All.
2. Plug the calculator into your computer with its USB cable. Turn it on.
3. Open TI Connect CE and choose Calculator Explorer.
4. Drag the included clibs.8xg onto your calculator. Choose Archive and Send.
5. Drag CEREADER.8xp onto your calculator. Choose RAM and Send.
6. For OS 5.5-5.8.4 only, send arTIfiCE_v2.1.8xp to RAM too.

Open the reader once:

OS 5.0-5.4:
  Press 2nd, then 0. Find Asm( in the catalog and press ENTER.
  Press PRGM, choose CEREADER, press ENTER, then ).
  The screen should say Asm(prgmCEREADER). Press ENTER to run it.

OS 5.5-5.8.4:
  Press PRGM. Choose TI-Basic if asked. Choose A, then press ENTER twice.
  In the arTIfiCE menu, choose CEREADER and press ENTER.

The reader will say No story. That is normal! Write down the free archive
space it shows. Press CLEAR to exit. Press MODE too if arTIfiCE's menu appears.

Make your first document:

1. Open app. On Windows/Linux, open CEreader inside that folder. On Mac,
   app itself is the application. No Python or setup script is needed.
2. Choose Website Link (the default) or Upload my own file.
   Website Link shows a link box and the mature-content checkbox. Currently
   see Natively supported websites in the app for the current list.
   Upload my own file shows a drop box
   and Choose file button; your file stays on this computer.
3. In file mode, drop ONE document into the box or click Choose file.
   Use PDF, HTML, Markdown, TXT, DOCX, ODT, RTF or unencrypted EPUB.
   Other common plain-text files work too. Website story imports exclude author
   notes and reader comments. Your own files are read locally and are never uploaded.
4. Enter the free archive bytes you wrote down.
5. Click Generate files. Your files go into CEreader Output in Documents
   (or your home folder if Documents is unavailable).
6. Choose Part 1, then click Show files to drag.
7. A folder opens containing ONLY the calculator files for that part.
8. Select ALL files in that folder: Ctrl+A on Windows/Linux, Command+A on Mac.
9. Drag them to the calculator in TI Connect CE. Choose Archive, then Send.
10. Open CEREADER on your calculator again. Choose the story with UP/DOWN,
    then ENTER. Use LEFT/RIGHT to turn pages. CLEAR saves and returns to the
    story list. CLEAR in the list exits.

Linux users upload the same selected .8xv files with WebTILP's transfer control;
the TI Connect CE drag-and-drop step above applies to Windows and Mac.

More stories and later parts:

Other stories can stay on your calculator when there is enough free Archive space.
Newly generated stories have separate calculator filenames and separate saves.
Install this download's new CEREADER.8xp before using new story files.

Story folders use NUMBER - TITLE - BYTES, for example 996079 - HEART - 12,345.
The first number is the website's story number (or a stable number for local files).
The last number is the exact size of the original calculator .8xv files across
ALL parts. It excludes previews, source files and duplicate Files to send copies.
It does NOT include the safety reserve and is not one part's free-space requirement.

Each PART folder and Files to send folder shows its own bytes needed, including an
8,192-byte safety reserve. Compare THAT number with CURRENT free archive bytes
shown at the bottom of the calculator's story list. If needed is higher, DO NOT
send it yet. Remove an unwanted part or generate smaller parts. Enter CURRENT
free bytes before generating another document. Check free space after each part.

Exit the reader before changing files. Open your saved collection in the computer
app, choose a part, then Show files to drag. Send all its files to Archive.
Choose the installed story/part in the calculator's list with UP/DOWN and ENTER.
LEFT/RIGHT in the list jumps five entries. Keep the whole computer collection.

To remove a story part, read THAT part's TRANSFER.txt. It lists exactly which
calculator AppVars belong to that part. Delete only those names. Keep its P.......
save AppVar if you want to resume later. Keep the reader, libraries and other stories.

One older single-story collection can stay alongside new stories. Multiple older
collections cannot coexist: regenerate additional stories from the original
PDF/HTML/TXT/etc. using the new app. Keep all legacy progress/save AppVars.

About this download:

Independent software; not affiliated with supported websites or Texas Instruments.
Importing a story does not give permission to redistribute it.
No ROMs, emulator or stories are included. LICENSES contains required notices.
Source and calculator relinking materials are a separate download on the same
website: CEreader_2.0.0_rc16_Source.zip. Keep app's supporting files together.

Document limits:

Documents are limited to 64 MiB; extracted text to 8 million characters.
PDFs are limited to 2,000 pages and need selectable text. Scanned/image-only
PDFs need OCR first; CEreader does not perform OCR. Password-protected PDFs,
encrypted EPUB resources and old .doc files are unsupported. Export an
unprotected TXT, PDF, DOCX or ODT file instead. Images become markers.
Fonts, columns, tables and alignment can change; review the previews.
Markdown and other text markup may remain visible as ordinary text.

rc14 update: Replace CEREADER.8xp in RAM after exiting the reader. Existing
stories and progress remain compatible. Chunk checks/opening are much faster;
Checking next pages briefly appears when first entering an unchecked data file.
No calculator OS update or story regeneration is needed.

rc15 desktop update: The author-notes option has been removed for the MVP.
New website and local website HTML imports exclude author notes and reader comments.
Previously generated collections remain usable; they are not rewritten.
Calculator program is unchanged from rc14, including its faster loading fix.

rc16 update: CEreader uses general document-reader wording throughout its UI
and instructions. The app lists current link providers under Natively supported
websites. Other sites need a locally saved document. Existing stories, parts and
progress remain usable; the calculator program and format are unchanged.
