Skip to content

TalesTrove is a browser extension that allows users to easily save links to their favorite fictional stories and series.

License

Notifications You must be signed in to change notification settings

Jemeni11/TalesTrove

Repository files navigation

Logo

TalesTrove

Easily Save Your Favorite Stories for Later.

Explore the repo »

Table of Contents

Introduction

TalesTrove is a browser extension that allows users to easily save links to their favorite fictional stories and series from various platforms.

This project was built using the Plasmo framework.

(back to top)

Supported Sites

  • FanFiction.net
    • Favorites Stories
    • Following Stories
  • Archive Of Our Own
    • Work Subscriptions
    • Series Subscriptions
    • Author Subscriptions
  • QuestionableQuesting
    • Watched Threads
  • SpaceBattles
    • Watched Threads
  • Sufficient Velocity
    • Watched Threads

(back to top)

Sites Planned for Support

  • Archive Of Our Own
    • Bookmarks

(back to top)

Features

  • Save favorites and followed stories from multiple supported platforms
  • Export saved links in multiple formats:
    • JSON for data processing
    • TXT for simple text listings
    • CSV for spreadsheet compatibility
    • HTML for web viewing
    • Bookmark HTML for browser importing
    • LinksOnly TXT for plain links, line-separated, ideal for easy parsing when only the links are needed, including use with fanfiction tools like FicHubCLI.
  • Simple, user-friendly interface

(back to top)

Installation

Browser Extension Stores

  • Mozilla Firefox Browser Add-ons: Link
  • Microsoft Edge Add-ons: Link

The extension will be available on other browser stores soon. Check back for updates.

(back to top)

Using Pre-built Files

Important

You must enable Developer Mode in Chrome/Chromium.

  1. Go to the Releases Page.

  2. Download the file for your browser:

    • For Chrome/Chromium: Download chrome-mv3-prod.zip
    • For Firefox: Download firefox-mv2-prod.zip
  3. Install the extension:

    • Chrome and Chromium browsers:

      1. Extract the downloaded zip file.
      2. Go to chrome:extensions.
      3. Click Load Unpacked.
      4. Select the extracted folder.
    • Firefox:

      1. Go to about:debugging#/runtime/this-firefox.
      2. Click Load Temporary Add-on....
      3. Select the Firefox zip.

(back to top)

Building From Source

Important

You must enable Developer Mode in Chrome/Chromium.

Important

This extension requires Node and pnpm for building.

Note

This extension was built with

  • Node v22.13.0
  • pnpm v9.15.3
  • Windows 11 Pro 21H2
  1. Clone the repository and install dependencies.

     git clone https://www.github.com/Jemeni11/TalesTrove.git
     cd TalesTrove
     pnpm install
  2. For development

    pnpm dev

    Then load the appropriate development build from the build directory.

  3. For production

    • Chrome (and other Chromium Browsers)

      pnpm build
    • Firefox

      pnpm build:firefox
  4. Install the built extension

    • Chrome (and other Chromium Browsers):

      1. Go to chrome:extensions.
      2. Click Load Unpacked.
      3. Navigate to the build folder and select the Chrome build.
    • For Firefox:

      1. Go to about:debugging#/runtime/this-firefox.
      2. Click Load Temporary Add-on....
      3. Navigate to the Firefox build folder and select the manifest.json file.

For further guidance, visit Plasmo's Documentation

(back to top)

Usage

Warning

You must be logged in to the respective websites to use the extension.

  1. Click on the TalesTrove icon in your browser's extension area.
  2. Configure your preferences for each supported website.
  3. Use the "Download Links" section to export your saved links.

(back to top)

FAQ

  • Why do you need my Archive username?

    Unlike other sites, Archive Of Our Own requires a username to access user-specific subscriptions (such as works, series, and authors). TalesTrove needs to link to your account to retrieve this data.

  • Why do I need to be logged in?

    You need to be logged in to your accounts on supported platforms because TalesTrove interacts with personalized data—such as your favorites, followed stories, or subscriptions—which requires authentication to access. Without logging in, the extension can't fetch this data for you.

  • Does this extension save/steal any of my data?

    Nope, TalesTrove doesn’t collect, store, or share any of your data. The extension doesn't send your info to third parties and doesn't track telemetry. So if this crashes... well, (no beta data, we die like men!).

    The only data TalesTrove stores is what you save when you click "Download". Your saved links are only stored locally on your own computer—it's not hoarded or sent anywhere. It’s all private, secure, and stays with you.

    Additionally, this project is open source, so you can review the code yourself (or have someone who knows React and TypeScript take a look) to verify these privacy claims.

(back to top)

Contributing

Contributions are welcome! If you'd like to improve TalesTrove, please feel free to submit a pull request.

(back to top)

Why did I build this?

I like fanfiction and I like having local copies of my data. So, I built this extension to get my data for me!

I've made other fanfiction tools before like FicImage. I've also contributed to tools like WebToEpub and Leech.py.

(back to top)

Wait a minute, who are you?

Hello there! I'm Emmanuel Jemeni, and I am a Frontend Developer.

You can find me on various platforms:

If you'd like, you can support me on GitHub Sponsors or Buy Me A Coffee.

(back to top)

License

GPL-3.0 license

(back to top)

Changelog

Changelog

(back to top)

About

TalesTrove is a browser extension that allows users to easily save links to their favorite fictional stories and series.

Resources

License

Stars

Watchers

Forks

Packages

No packages published