Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/RoiArthurB/Side-Auto_Sci-Hub

Cross-Browser Plugin to open Sci-Hub πŸ— page with the article from your current tab
https://github.com/RoiArthurB/Side-Auto_Sci-Hub

brave-extension chrome-extension chromium-extension firefox-addon sci-hub sci-hubextension scihub side-project

Last synced: 6 days ago
JSON representation

Cross-Browser Plugin to open Sci-Hub πŸ— page with the article from your current tab

Awesome Lists containing this project

README

        

# Auto Sci-Hub ![Auto Sci-Hub Logo](https://raw.githubusercontent.com/RoiArthurB/Side-Auto_Sci-Hub/master/icons/logo-128.png)

[![Language](https://img.shields.io/badge/language-JavaScript-brightgreen.svg)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
![GitHub](https://img.shields.io/github/license/RoiArthurB/Side-Auto_Sci-Hub.svg)
![Auto Release](https://github.com/RoiArthurB/Side-Auto_Sci-Hub/workflows/Auto%20Release/badge.svg)

![Maintenance](https://img.shields.io/maintenance/yes/2023.svg)

[~~Available on addons.mozilla.org~~](https://addons.mozilla.org/en-US/firefox/addon/auto-sci-hub/)

> Don't respect Mozilla's rules πŸ˜’
> View report mail
> Dear contributor,
>
> We received a notification under Mozilla’s Digital Millennium Copyright Act (β€œDMCA”) and Trademark policy (https://www.mozilla.org/about/legal/report-infringement/) complaining of allegedly infringing activity by you on our service at https://addons.mozilla.org/en-US/firefox/addon/auto-sci-hub. We have removed or disabled access to your add-on identified by the claimant as infringing the claimant's trademark.
>
> The notice included the following report:
>
> From DeVore & DeMarco LLP:
>
> We are litigation counsel for Elsevier Inc., a leading publisher of scientific, engineering, and medical books and journals. Elsevier provides , among other things, the ScienceDirect platform, through which it distributes scientific journal articles in which it holds the copyright. In order to protect its copyright interest in those articles, Elsevier brought a civil action against a number of websites commonly known as "Sci-Hub" and "LibGen" or "Library Genesis" and their respective mirrors which engage in the large-scale infringement of those copyrights. On June 21, 2017, Elsevier obtained a judgement against those websites which, among other things, enjoined the websites, their operators, and anyone acting in concert with them, from infringing Elsevier' s copyrighted works or assisting others in doing so.
>
> We write to inform you of the presence of a number of add-ons for the Firefox web browser which are designed specifically to assist their users in infringing Elsevier 's (and other publisher') copyrights through the websites operated by the defendants in the above-mentioned civil action. We request that these extensions be removed from the Firefox Browser Add-Ons website (addons.mozilla.org) because they (1) violate the DMCA, including Section 1201 (circumvention of copyright protection systems); (2) operate in concert with the defendants in the above-mentioned civil action to violate Elsevier's copyrights in violation of the court 's order enjoining such conduct; and (3) are manifestly in violation of Mozilla's Conditions of Use (https://www.mozilla.om:/enUS/about/legal /acceptable-useD which expressly prohibit, among other things, illegal content and content which violates the copyright or other intellectual property rights of others. We therefore request that the following add-ons be promptly removed.
>

[~~Available on chrome.google.com~~](https://chrome.google.com/webstore/detail/auto-sci-hub/nlogbpfgpkffmombiknfdoogphkimmmd/related?hl=en-US&authuser=0)

> Don't respect Google's rules πŸ˜’
>
> View report mail
> Dear developer,
>
> Your Google Chrome item "Auto Sci-Hub" with the ID nlogbpfgpkffmombiknfdoogphkimmmd did not comply with our rules and has been removed from the Chrome Web Store.
>
> Your item did not comply with the following section of our Program Rules :
>
> "Content Rules"
>
> * We do not authorize products or services that facilitate unauthorized access to the content of websites that bypass paywalls.
>
>
> Once your item complies with the Chrome Web Store rules, you will be able to request that it be republished on the Chrome Web Store Developer Dashboard. Before publishing it again, we will check if it is compliant.
>
> Please respond to this email if you have any questions about its content. The Chrome Web Store Developer Support team will contact you to follow up on your request.
>
>
> Important Note :
>
> Repeated or harmful non-compliance with the Chrome Web Store rules can lead to suspension of your developer account or banning from using the Chrome Web Store platform.
>
> It may also lead to the suspension of related Google services associated with your Google Account.
>
>
> Sincerely,
>
> Chrome Web Store Developer Support
>

[Available on Github release](https://github.com/RoiArthurB/Side-Auto_Sci-Hub/releases/latest)

> Check the doc (quick link [here](https://roiarthurb.github.io/Side-Auto_Sci-Hub/#installing)) to see how to simply install on your browser 🐻

## Background

I was tired to copy the URL of pages to paste it in [Sci-Hub](https://en.wikipedia.org/wiki/Sci-Hub) website 100 times per hours while I was reading scientific papers.

So I've created a very simple button addon for [Mozilla Firefox](https://www.mozilla.org/en-US/firefox/) which do it all for me.

## Installing

### Firefox

View contents


  1. Download the .xpi file from the latest release

  2. Click the Continue to install pop-up button

  3. Enjoy the plugin bear


### Chrome/Chromium

View contents


  1. Download the .crx file from the latest release

  2. Open the chrome://extensions/ link

  3. Enable the Developer Mode

  4. Drag and drop the downloaded crx file in the browser window

  5. Click the Add extension pop-up button

  6. Enjoy the plugin bear

### Zip developper install (hard mode)

View contents

Firefox

Open the debug page on the addon section


about:debugging#addons


Depending on your version of Firefox, this link may redirect you somewhere else. e.g. Ff 71 => about:debugging#/runtime/this-firefox



From that webpage, press the bug button Load Temporary Addon-On... and choose the manifest.json.



Chrome/Chromium




  1. Download and extract the latest zip from https://github.com/RoiArthurB/Side-Auto_Sci-Hub/releases

  2. Delete _config.yml from the folder (Chrome doesn't like reading files starting with _ for some reason but this file is for the GitHub Pages site so removing it isn't an issue)

  3. Go to Chrome's extensions page, enable Developer Mode

  4. Click Load unpacked, and select the extracted zip folder.


You'll also need to right click the Open in Sci Hub toolbar icon now, click Options, then change the URL to another Sci-Hub mirror because whereisscihub.now.sh is down.


Also, as written above, the plugin is not (and will never be) on the chrome store because it doesn't respect it's policy



Prohibited Products:


We don't allow products or services that:



  • Facilitate unauthorized access to content on websites, such as circumventing paywalls or login restrictions

  • Encourage, facilitate, or enable the unauthorized access, download, or streaming of copyrighted content or media

  • Mine cryptocurrency


## How to use

### Firefox addon button

Go on scientific page with PDF hidden behind a paywall, click on the _Auto Sci-Hub_ button, and Sci-Hub will pop up with your PDF on another tab πŸ˜€

Before | After
--- | ---
![Before screen](https://raw.githubusercontent.com/RoiArthurB/Side-Auto_Sci-Hub/master/ressources/before.jpg) | ![After screen](https://raw.githubusercontent.com/RoiArthurB/Side-Auto_Sci-Hub/master/ressources/after.jpg)

### Context Menu

If you right click on a link, you'll see in the contextual menu a line to open to location of that link in sci-hub.

It's also possible to do the same by right clicking anywhere on the webpage. In that case it will open the current web page on sci-hub.

Link | Page
--- | ---
![contextual link](https://raw.githubusercontent.com/RoiArthurB/Side-Auto_Sci-Hub/master/ressources/link.png) | ![contextual page](https://raw.githubusercontent.com/RoiArthurB/Side-Auto_Sci-Hub/master/ressources/page.png)

### Options

Also, from the version 2.0, you're now free to choose your how redirection. That way you're able to use a raw IP address, your own instance of [WhereIsSciHub](https://gitlab.com/Flockademic/whereisscihub), or whatever you want πŸ˜€

![ASH option view](https://user-images.githubusercontent.com/6759913/73458392-7caa6d80-4375-11ea-96b9-a25a754c6707.png)

## Built With
* [Where Is Sci-Hub Now ?](https://whereisscihub.now.sh/) - List several alternative working links to active Sci-Hub mirrors

> FYI - The plugin currently use a fork fixed of the official WhereIsSciHub, _Vinni_ (the author of that tool) can't update his version now so I'm using [a fork](https://gitlab.com/Flockademic/whereisscihub/-/merge_requests/4) to have a working plugin ! :D

## Authors

* **Arthur Brugiere** - *Initial work* - [RoiArthurB](https://github.com/RoiArthurB)

## Contribution

* **Giacomo Rossetto** - *Upgraded almost everything* - [Jackymancs4](https://github.com/Jackymancs4)
* **clef** - *Helped for the Firefox signing release* - [Clef-0](https://github.com/Clef-0)

## License

This project is licensed under the GPL 3 License - see the [LICENSE.md](LICENSE.md) file for details

## Acknowledgments

PS: If the plugin is not available on markets anymore, it must be due to the fact that it doesn't respect Market Policy, so build it from source (it's a very simple plugin based on JS API, so it should work on any browser version) and enjoy the plugin ! πŸ˜€πŸ˜€

PPS: If you love Sci-Hub too, support the project by sending a contribution to the Sci-Hub Bitcoin address: ***12PCbUDS4ho7vgSccmixKTHmq9qL2mdSns*** (check if it hasn't changed before giving ;) )