Skip to content

Install and usage

This page instructs how to use and build the source code for Chrome.

RetroTxt employs an open-sourced license with the code available on GitHub.

You'll require the following command line tools to download and initialize the repository.

  • git - the distributed version control software
  • Node.js - an open-source, cross-platform JavaScript runtime environment
  • pnpm - an efficient package manager for Node.js
  • Task - a task runner / build tool that aims to be simpler and easier to use

Visual Studio Code is used to create RetroTxt. It includes optional .vscode conveniences, such as workspace settings and extension recommendations.

Clone the repo

Download and copy the RetroTxt repository to the current directory.

git clone https://github.com/bengarrett/RetroTxt.git

Install the dependencies

RetroTxt has a few third-party dependencies and tools for initialization in the repository.

cd RetroTxt
pnpm install
task depends

(optional) Edit the manifest file

Some may wish to edit the Extension manifest containing the base configuration, permissions, and metadata for RetroTxt.

  "host_permissions": [
    "*://*.retrotxt.com/*",
    "https://*/",
    "http://*/",
    "file://*/"
  ],

The RetroTxt/ext/manifest.json file contains the configuration and metadata for RetroTxt.

Run the source code

I suggest that you create a new user profile for the the Extension.

Open a new tab with the address of the Extensions features.

The chrome://extensions/ address will work in other browsers such as Edge

chrome://extensions/
  1. In the Extensions tab, toggle Developer mode
  2. Click the Load unpacked button
  3. Navigate to the directory containing the RetroTxt/ext/ repository and select OK

RetroTxt should load!

Chrome extensions developer mode