An open API service indexing awesome lists of open source software.

https://github.com/rwanyoike/tolon-browser-extension

💻 Find webpage discussions on the web: Hacker News, Reddit, etc.
https://github.com/rwanyoike/tolon-browser-extension

browser-extension chrome-extension firefox-extension hacker-news javascript reddit

Last synced: 23 days ago
JSON representation

💻 Find webpage discussions on the web: Hacker News, Reddit, etc.

Awesome Lists containing this project

README

        

# Tolon Browser Extension

[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/rwanyoike/tolon-browser-extension/nodejs-package.yml?branch=main)
](https://github.com/rwanyoike/tolon-browser-extension/actions/workflows/nodejs-package.yml?query=branch%3Amain)
[![GitHub License](https://img.shields.io/github/license/rwanyoike/tolon-browser-extension)
](LICENSE.txt)
[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/mohaijbbfgjjjjbhffgaifcnookdihmk)](https://chrome.google.com/webstore/detail/tolon/mohaijbbfgjjjjbhffgaifcnookdihmk)
[![Mozilla Add-on](https://img.shields.io/amo/v/tolon-browser-extension)](https://addons.mozilla.org/en-US/firefox/addon/tolon-browser-extension)

> Find webpage discussions on the web. (e.g. Hacker News, Reddit)

Tolon (토론) is a browser extension that helps you find discussions around the pages you're looking at on the web. It works by searching [available sources](#usage) for URL submissions.

[Installation](#installation) | [Usage](#usage) | [Attribution](#attribution) | [Contributing](#contributing) | [License](#license) | [Similar Extensions](#similar-extensions)

| ![_](assets/syASQfx.png) | ![_](assets/06lpJWv.png) |
| ------------------------------------- | ------------------------------------- |
| ![_](assets/y0Z85pE.png) | ![_](assets/vNioIDh.png) |

## Installation

These are the extension's [permissions](public/manifest.json):

```json
"permissions": [
"activeTab"
]
```

**activeTab**:

This is necessary to be able to:

- Find out which tab is currently active.
- Query the webpage URL.

### Chromium

[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/mohaijbbfgjjjjbhffgaifcnookdihmk)](https://chrome.google.com/webstore/detail/tolon/mohaijbbfgjjjjbhffgaifcnookdihmk)

You can install the latest version from the [Chrome Web Store](https://chrome.google.com/webstore/detail/tolon/mohaijbbfgjjjjbhffgaifcnookdihmk). It's expected that the extension is compatible with any Chromium-based browsers.

### Firefox

[![Mozilla Add-on](https://img.shields.io/amo/v/tolon-browser-extension)](https://addons.mozilla.org/en-US/firefox/addon/tolon-browser-extension)

You can install the latest version from the [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/tolon-browser-extension) web site.

## Usage

While viewing a webpage, opening the extension will search available sources for URL submissions (discussion threads) and present a list of results.

Available sources:

- [Hacker News](https://news.ycombinator.com)
- [Reddit](https://www.reddit.com)
- [Sample Site](src/sources/sample-site/index.ts) (template)

## Build

To build the browser extension:

```shell
# Clone the repository
git clone https://github.com/rwanyoike/tolon-browser-extension.git
# Navigate to the project directory
cd tolon-browser-extension
# Install the dependencies
npm install
# Build the browser extension
npm run build
```

Find the browser extension under `dist/`.

## Attribution

- Icon by [Asier Bilbo](https://thenounproject.com/creator/asierbilbo) from Noun Project.

## Related Projects

- [Discussed Elsewhere](https://github.com/jsuar/discussed-elsewhere)
- [Newsit](https://github.com/benwinding/newsit)