https://github.com/aokellermann/nexus-now
Access scientific literature in your browser using standard template construct, an IPFS-backed website for nexus search.
https://github.com/aokellermann/nexus-now
browser-extension chrome-extension edge-extension firefox-addon firefox-extension nexus-search open-access openscience standard-template-construct webextension
Last synced: 26 days ago
JSON representation
Access scientific literature in your browser using standard template construct, an IPFS-backed website for nexus search.
- Host: GitHub
- URL: https://github.com/aokellermann/nexus-now
- Owner: aokellermann
- License: mit
- Created: 2023-05-07T01:29:25.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-07-23T03:34:36.000Z (9 months ago)
- Last Synced: 2024-07-30T19:42:00.829Z (9 months ago)
- Topics: browser-extension, chrome-extension, edge-extension, firefox-addon, firefox-extension, nexus-search, open-access, openscience, standard-template-construct, webextension
- Language: JavaScript
- Homepage:
- Size: 62.5 KB
- Stars: 53
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nexus Now!
Inspired by [Sci-Hub Now!](https://github.com/gchenfc/sci-hub-now)
## Usage
When on a website for an article that is identifiable by a [DOI](https://www.doi.org/the-identifier/what-is-a-doi/),
click the Nexus Now extension icon. The [STC](https://libstc.cc) page for that article will be
opened in a new tab. If you enable autodownload, a PDF of the article will attempt to download.
### Autodownload
STC provides a [Hub API](https://hub.libstc.cc), which maps a DOI
to a PDF. Nexus Now uses this API to automatically download PDFs of articles.
The PDF may not be accessible through this API, but may still be accessible through STC, so if Nexus Now cannot find the
PDF within 30 seconds, STC will be opened in a new tab as if autodownload is not enabled.
You can opt in or out of autodownload:
#### Chrome/Edge
1. Right click the extension icon or click the three dots next to the extension icon and select "Options" from the dropdown.
2. Check or uncheck autodownload.
#### Firefox
1. Right click the extension icon or click the gear next to the extension icon and select "Manage extension" from the dropdown.
2. Check or uncheck autodownload.
## Installation
You can manually install the extension using the installers attached in
the [latest release](https://github.com/aokellermann/nexus-now/releases). The `.xpi` installer should work for
gecko-based browsers (Firefox), and the `.crx` installer should work for Chromium-based browsers (basically everything
else).
### Chrome/Edge
#### Windows/MacOS
1. Go to the [latest release](https://github.com/aokellermann/nexus-now/releases) and download the `chromium.zip` file.
2. Go to the webpage [chrome://extensions/](chrome://extensions/) and make sure the toggle `Developer mode` is on. This will allow you to install extensions unaffiliated with the Chrome Web Store.
3. Drag the downloaded `.zip` file anywhere onto the page to install the extension.
#### Linux
1. Go to the [latest release](https://github.com/aokellermann/nexus-now/releases) and download the `.crx` file.
2. Go to the webpage [chrome://extensions/](chrome://extensions/) and make sure the toggle `Developer mode` is on. This will allow you to install extensions unaffiliated with the Chrome Web Store.
3. Drag the downloaded `.crx` file anywhere onto the page to install the extension.
### Firefox
1. Go to the [latest release](https://github.com/aokellermann/nexus-now/releases) and download the `.xpi` file.
2. It will ask you if you want to install the addon. Click yes.
## Updating
Automatic extension updating was introduced in version 0.2.1 and should work at least on Linux. If you have an older version than 0.2.1 installed,
it is highly recommended that you manually install the latest version, which will subsequently be able to update
itself without your manual intervention.
## Compatibility
This extension uses Manifest V3, which is supported in:
- Firefox >= 109
- Chromium >= 88
## Building
You can build the extension yourself:
First, install dependencies:
```bash
npm install -g web-ext
````
Then build:
```bash
./build.sh
```