Please read this.

I'm taking another break for a while. My anxiety isn't holding up well and I need to take some time for myself to recover. Frankly, modding can be a thankless job and some of the people one is forced to interact with can be... deeply unpleasant at best, to put it in the kindest way I can and not as I truly want to. For now, I feel like my mods don't need any further work done to them. They're fine as they are. See you later, folks.

I'll be back! I'm not gone for good, I just need to set this aside for now. That's all.

One thing I will say as a final note is that it'd be nice if one could turn off the comments system and only have a bug tracker in the vein of Nexus Mods. That'd be handy for people like myself who do deal with anxiety. And I deal with a lot of anxiety.

See you around, folks. My thanks to those who were kind.

Notice: Please download the addon from this location for now, and report back in the comments if you crash while trying to import from the lore library, thank you.

Click here to check out my other addons.

The Now Actually Working edition! Sorry about that.

Description

Wouldn't it be nice if you had a Lore Library, but for every book you encountered across your travels? Recorded, readable at any point, with a way to keep track of which books you have/haven't read, sortable by various factors (such as alphabetical, the time you found the book, et ceteara), and searchable for when you're seeking out that specific bit of lore? Welcome to Pocket Apocrypha, your own little slice of Hermorah's own realm right in your proverbial pocket!

Now you don't have to stop to read every single book along the way, you can rest easy and trust that they're all being stored in your own little pocket realm to be retrieved later.

This is a port of Librarian. For more information, see the FAQ below.

Features

In the hallowed words of our dear Commandant Lassard, Pocket Apocrypha can do many, many fine things for you.

• Captures a book (in its entirety for you to read later, accessible from a user-friendly interface;
• When you do come back to your book, it'll look exactly as it did in the world as the addon uses the same UI for displaying books that the game itself does;
• Whenever you collect a book the time of collection is recorded, you can then sort books to be displayed by their collection date so you can see what's new and what's old;
• With a keypress or the push of a button (either clicking the binding or right-clicking the item in the list) you can easily mark books read or unread, to know which titles you've absorbed into your concept organ;
• A marker in Pocket Apocrypha's interface and in the very book itself which shows you whether a book is read or unread;
• Books can be easily imported from your Lore Library collection at the push of a button;
• You can toggle between whether you want to show all of the books you've seen or just the books you've seen on your current character with the push of a button;
• You can search the titles and/or the contents of books for when you have a need to find a certain old book or do a little scholarly lore research;
• The interface can be opened via a key bind or a slash command (/apocrypha);
• Books in Pocket Apocrypha can be sorted by a variety of factors -- title, time found, book size (word count), and unread/read;
• Alert options for when you find a new book (center screen message, chat message, or none);
• A reminder can be set (or not, whichever you desire) to reload your UI after a configurable amount of discovered books (so, for example, it'll remind you after 5 books found);
• The ability to mark all of your books read/unread at the press of a button;
• You can view the options by clicking the gear in the addon's interface, by going into the usual addons menu, or via a slash command (/apocryphaoptions);
• It's fully localisable in every respect (only English thus far, but other languages might arrive later);
• An incredibly safe database system which properly tracks books (including those with the same titles) via their IDs.

That is a lot of things, isn't it? Well, it's all very friendly and easy to understand, as you can see from the screenshot.

It also has a collection of utilities!

• Backup -- Make instantiated backups of your database;
• Restore -- Restore your latest database backup;
• Merge -- Merge two databases together;
• Export -- Dump a list of names of books you've read to a text file;
• Update -- For when the database needs to be updated (I'll let you know).

There's an instructions file in the Utils folder to get you started in understanding what each utility does, along with detailed steps for their use.

If you have any further ideas, let me know in the comments.

FAQ

Q: Why port? What's wrong with Librarian?

A: That's tricky to answer. I could point at how a change in the handling of
book meidums has rendered Librarian broken, anyway, and databases ruined; I could point at how it has a number of existing bugs which I wanted to fix; I could also point at the new functionality and improved features of Pocket Apocrypha; I could... but none of those are the reason you should switch.

The main reason is that Librarian was storing books by their titles, rather than the internal book IDs supplied by Zenimax Online Studios. Here are the problems that can occur with that:

• If two books have the same title, the new book you've encountered won't be stored even if the contents are completely different;
• If ZOS changes the title of a book for any reason, it means you'll now have a false copy of that book under a different title which erroneously bloats your collection;
• If ZOS changes the contents of a book (typos, corrections, changes to the book medium, et cetera), those changes will never be incorporated back into Librarian.

This is all fixed in Pocket Apocrypha. Every book you find will be stored by its unique book ID, so you won't encounter any of the above problems. Furthermore, thanks to using IDs, Pocket Apocrypha will update your books as you find them in the world again to match any changes ZOS might've made.

The release of Pocket Apocrypha was necessary. Not desirable, perhaps, but absolutely necessary.

Q: I'm a user of the original Librarian addon. Can I use my old database with Pocket Apocrypha?

A: No. I'm sorry. Due to the books being stored by title, there's absolutely no means to salvage that database. It's ruined. The sooner you start over, the better. I'm sorry to have to say it, but Librarian's database is simply that broken, you're better off going at it with a fresh start, knowing each book is stored by its ID and thus is future-proofed against any cataclysmic changes (like the ones that befell Librarian).

Q: I used the builds of Librarian you released under the comments section, can I use that database?

A: Yes. It will need to be converted but that database is 100 per cent compatible due to its use of book IDs. Use the database update utility to convert your old Librarian database over Pocket Apocrypha standards.

Q: Will you setup a system where people can share their books so that we can all have a complete database?

A: No. It'd be far too easy to inject nonsense into it as I have no means of verifying what is or is not a real book. So someone could include a book about penises, and if it were written well enough we'd be none the wiser that it wasn't in the game itself.

This would lead to people talking about ESO having books about penises. That'd be bad for everyone involved. So, sadly, this can't happen.

Credits

My ever patient beau who manages to sometimes raise my courage to the point where I can post things online.