|
|
|
@ -1,32 +1,48 @@
|
|
|
|
|
# ![img](/src/img/logo.png) Share Freedom - browser extension
|
|
|
|
|
[![jest](https://jestjs.io/img/jest-badge.svg)](https://github.com/facebook/jest)
|
|
|
|
|
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
|
|
|
|
|
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/davidnguyen179/web-extension-boilerplate/pulls)
|
|
|
|
|
![ci/cd](https://github.com/davidnguyen179/web-extension-boilerplate/workflows/ci/cd/badge.svg)
|
|
|
|
|
|
|
|
|
|
# ![img](https://gitlab.com/uploads/-/system/project/avatar/16473487/logo-min.png) Fedishare
|
|
|
|
|
|
|
|
|
|
Share the current tab on the [fediverse](https://fediverse.party/).
|
|
|
|
|
|
|
|
|
|
[![Firefox Add-on](/src/img/badge-amo.png)](https://addons.mozilla.org/en-US/firefox/addon/share-freedom/)
|
|
|
|
|
## Get the extension
|
|
|
|
|
|
|
|
|
|
### Gecko
|
|
|
|
|
|
|
|
|
|
| Firefox Add-ons | Trisquel Add-ons |
|
|
|
|
|
---|---
|
|
|
|
|
[![img](https://upload.wikimedia.org/wikipedia/commons/thumb/a/a0/Firefox_logo%2C_2019.svg/77px-Firefox_logo%2C_2019.svg.png)](https://addons.mozilla.org/en-US/firefox/addon/fedishare-addon) | [![img](https://trisquel.info/files/avatars/picture-1.png)](https://trisquel.info/en/browser/addons/fedishare)
|
|
|
|
|
|
|
|
|
|
### Blink (In process)
|
|
|
|
|
|
|
|
|
|
| Chrome Web Store | Opera addons |
|
|
|
|
|
---|---
|
|
|
|
|
![img](https://storage.googleapis.com/chrome-gcs-uploader.appspot.com/image/WlD8wC6g8khYWPJUsQceQkhXSlv1/tbyBjqi7Zu733AAKA5n4.png) | ![img](https://addons-static.operacdn.com/static/header-footer/css/img/opera-addons.png)
|
|
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
|
|
Simplest add-on for the fediverse. Share web pages right from the toolbar button.
|
|
|
|
|
|
|
|
|
|
Supported services/protocols:
|
|
|
|
|
- Gnusocial
|
|
|
|
|
- Mastodon / Misskey
|
|
|
|
|
- Hubzilla
|
|
|
|
|
### Supported services/protocols:
|
|
|
|
|
|
|
|
|
|
- Diaspora
|
|
|
|
|
- Friendica
|
|
|
|
|
- Socialhome
|
|
|
|
|
- Gnusocial
|
|
|
|
|
- Hubzilla / Zap
|
|
|
|
|
- Lemmy
|
|
|
|
|
- Mastodon / Misskey
|
|
|
|
|
- Pleroma
|
|
|
|
|
- Osada / Zap / Zot6
|
|
|
|
|
- Socialhome
|
|
|
|
|
- XMPP
|
|
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
You can contribute in the following ways:
|
|
|
|
|
|
|
|
|
|
- Finding and reporting bugs
|
|
|
|
|
- Contributing code to the project by fixing bugs or implementing features
|
|
|
|
|
- Finding and reporting bugs.
|
|
|
|
|
- Contributing code to the project by fixing bugs or implementing features.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Bug reports
|
|
|
|
@ -38,133 +54,92 @@ Bug reports and feature suggestions can be submitted to [Gitlab Issues](https://
|
|
|
|
|
|
|
|
|
|
Please use clean, concise titles for your pull requests.
|
|
|
|
|
|
|
|
|
|
## Build
|
|
|
|
|
|
|
|
|
|
## Invite an ice cream
|
|
|
|
|
This project uses the [Web Extension Boilerplate](https://github.com/davidnguyen179/web-extension-boilerplate).
|
|
|
|
|
|
|
|
|
|
You can collaborate with __donations__ for the project :)
|
|
|
|
|
### Prerequisites
|
|
|
|
|
|
|
|
|
|
__Bitcoins:__ bc1qf7v8zty2yz8phulet29wcpxjclvffn5w6ry43w
|
|
|
|
|
Gecko
|
|
|
|
|
- Mozilla Firefox 59 (or higher)
|
|
|
|
|
|
|
|
|
|
__Ethereum:__ 0xca2FD9C3834694E2cB3db3bf79b3AfB083bA6732
|
|
|
|
|
**Install all dependencies:** `npm i`
|
|
|
|
|
|
|
|
|
|
![](/src/img/ice-cream.png)
|
|
|
|
|
[CC-BY 4.0 by Vincent Le Moign](https://commons.wikimedia.org/wiki/File:552-soft-ice-cream-2.svg)
|
|
|
|
|
### Development
|
|
|
|
|
|
|
|
|
|
##### Chrome
|
|
|
|
|
|
|
|
|
|
- Dev: `npm run app:chrome-dev`
|
|
|
|
|
- Production: `npm run app:chrome`
|
|
|
|
|
|
|
|
|
|
##### Edge
|
|
|
|
|
|
|
|
|
|
- Dev: `npm run app:edge-dev`
|
|
|
|
|
- Production: `npm run app:edge`
|
|
|
|
|
|
|
|
|
|
##### Firefox
|
|
|
|
|
|
|
|
|
|
- Dev: `npm run app:firefox-dev`
|
|
|
|
|
- Production: `npm run app:firefox`
|
|
|
|
|
|
|
|
|
|
#### Load package to browsers
|
|
|
|
|
|
|
|
|
|
1. Go to the browser's URL address bar
|
|
|
|
|
|
|
|
|
|
In Chrome:
|
|
|
|
|
2. Enter `chrome://extensions`
|
|
|
|
|
|
|
|
|
|
In Edge:
|
|
|
|
|
2. Enter `edge://extensions`
|
|
|
|
|
|
|
|
|
|
In Firefox:
|
|
|
|
|
2. Enter `about:debugging#/runtime/this-firefox`
|
|
|
|
|
|
|
|
|
|
In Chrome and Edge:
|
|
|
|
|
3. Turn on "**Developer mode**"
|
|
|
|
|
4. Load extension by clicking "**Load unpacked**"
|
|
|
|
|
5. Browse to `dist/` in source code.
|
|
|
|
|
|
|
|
|
|
In Firefox:
|
|
|
|
|
3. Click **Load Temporary Add-on...**
|
|
|
|
|
4. Browse to your `manifest.json` & click **Open**
|
|
|
|
|
|
|
|
|
|
#### CSS
|
|
|
|
|
|
|
|
|
|
[tailwindcss](https://tailwindcss.com) is the framework used for this project.
|
|
|
|
|
|
|
|
|
|
- Dev: `npm run style-dev`
|
|
|
|
|
- Production: `npm run style`
|
|
|
|
|
|
|
|
|
|
Set all css custom in: `public/styles.css`. The `main.css` is generated in `dist`.
|
|
|
|
|
|
|
|
|
|
## Donations
|
|
|
|
|
|
|
|
|
|
If you like the stuff I make and are financially able please consider donating. Your support allows me to dedicate more time to the projects I'm working on.
|
|
|
|
|
|
|
|
|
|
<a href='https://ko-fi.com/mugcake' target='_blank'><img height='35' style='border:0px;height:46px;' src='https://uploads-ssl.webflow.com/5c14e387dab576fe667689cf/5cbed8a433a3f45a772abaf5_SupportMe_blue-p-500.png' border='0' alt='Buy Me a Coffee at ko-fi.com' />
|
|
|
|
|
|
|
|
|
|
[![img](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/mickie/)
|
|
|
|
|
|
|
|
|
|
__Bitcoin BTC:__ bc1qf7v8zty2yz8phulet29wcpxjclvffn5w6ry43w
|
|
|
|
|
|
|
|
|
|
__Ethereum ETH:__ 0xca2FD9C3834694E2cB3db3bf79b3AfB083bA6732
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
This program is licensed under GPL v3
|
|
|
|
|
[![Large GPLv3 logo with “Free as in Freedom”](https://www.gnu.org/graphics/gplv3-with-text-136x68.png)](http://www.gnu.org/licenses/gpl-3.0.en.html)
|
|
|
|
|
|
|
|
|
|
Copyleft (ɔ) 2021 - Miguel (mickie)
|
|
|
|
|
Copyright (C) 2019-2021 Miguel (aka mickie) <millet@tuta.io>
|
|
|
|
|
This file is part of Fedishare.
|
|
|
|
|
Fedishare is free software: you can redistribute it and/or modify
|
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
|
(at your option) any later version.
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
|
|
|
|
See LICENSE file for more information.
|
|
|
|
|
|
|
|
|
|
## TODO
|
|
|
|
|
This boilerplate provides a skeleton to start developing cross-browser web extensions.
|
|
|
|
|
|
|
|
|
|
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
|
|
|
|
|
[![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg?style=flat-square)](#contributors-)
|
|
|
|
|
<!-- ALL-CONTRIBUTORS-BADGE:END -->
|
|
|
|
|
|
|
|
|
|
[![jest](https://jestjs.io/img/jest-badge.svg)](https://github.com/facebook/jest) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/davidnguyen179/web-extension-boilerplate/pulls)
|
|
|
|
|
![ci/cd](https://github.com/davidnguyen179/web-extension-boilerplate/workflows/ci/cd/badge.svg)
|
|
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm i
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**Chrome**
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run app:chrome-dev
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**Edge**
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run app:edge-dev
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**Firefox**
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run app:firefox-dev
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Production
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm i
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run app:chrome
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**Edge**
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run app:edge
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**Firefox**
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm run app:firefox
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Load package to browsers
|
|
|
|
|
|
|
|
|
|
**Chrome**
|
|
|
|
|
|
|
|
|
|
1. Go to the browser's URL address bar
|
|
|
|
|
2. Enter `chrome://extensions/`
|
|
|
|
|
3. Switch to "**Developer mode**"
|
|
|
|
|
4. Load extension by clicking "**Load unpacked**"
|
|
|
|
|
5. Browse to `dist/` in source code
|
|
|
|
|
6. Done!
|
|
|
|
|
|
|
|
|
|
Check here for more detail: [https://developer.chrome.com/extensions/getstarted](https://developer.chrome.com/extensions/getstarted)
|
|
|
|
|
|
|
|
|
|
**Edge**
|
|
|
|
|
|
|
|
|
|
1. Go to the browser's URL address bar
|
|
|
|
|
2. Enter `edge://extensions/`
|
|
|
|
|
3. Turn on `Developer mode`
|
|
|
|
|
4. Load extension by clicking "**Load unpacked**"
|
|
|
|
|
5. Browse to `dist/` in source code
|
|
|
|
|
6. Done!
|
|
|
|
|
|
|
|
|
|
**Firefox**
|
|
|
|
|
|
|
|
|
|
1. Go to the browser's URL address bar
|
|
|
|
|
2. Enter `about:debugging#/runtime/this-firefox`
|
|
|
|
|
3. Click **Load Temporary Add-on...**
|
|
|
|
|
4. Browse to your `manifest.json` & click **Open**
|
|
|
|
|
5. Done!
|
|
|
|
|
|
|
|
|
|
Check here for more details: [https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/](https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/)
|
|
|
|
|
|
|
|
|
|
## Contributors ✨
|
|
|
|
|
|
|
|
|
|
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
|
|
|
|
|
|
|
|
|
|
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
|
|
|
|
|
<!-- prettier-ignore-start -->
|
|
|
|
|
<!-- markdownlint-disable -->
|
|
|
|
|
<table>
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="center"><a href="https://www.dzungnguyen.dev"><img src="https://avatars.githubusercontent.com/u/6290720?v=4?s=100" width="100px;" alt=""/><br /><sub><b>David Nguyen</b></sub></a><br /><a href="https://github.com/davidnguyen179/web-extension-boilerplate/commits?author=davidnguyen179" title="Code">💻</a> <a href="https://github.com/davidnguyen179/web-extension-boilerplate/commits?author=davidnguyen179" title="Documentation">📖</a> <a href="#design-davidnguyen179" title="Design">🎨</a> <a href="#maintenance-davidnguyen179" title="Maintenance">🚧</a> <a href="https://github.com/davidnguyen179/web-extension-boilerplate/pulls?q=is%3Apr+reviewed-by%3Adavidnguyen179" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/davidnguyen179/web-extension-boilerplate/commits?author=davidnguyen179" title="Tests">⚠️</a></td>
|
|
|
|
|
<td align="center"><a href="https://github.com/immint023"><img src="https://avatars.githubusercontent.com/u/38607460?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Minh Ngo</b></sub></a><br /><a href="https://github.com/davidnguyen179/web-extension-boilerplate/commits?author=immint023" title="Code">💻</a> <a href="https://github.com/davidnguyen179/web-extension-boilerplate/commits?author=immint023" title="Tests">⚠️</a></td>
|
|
|
|
|
<td align="center"><a href="http://benlee3.com"><img src="https://avatars.githubusercontent.com/u/35267414?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ben Harned</b></sub></a><br /><a href="https://github.com/davidnguyen179/web-extension-boilerplate/commits?author=3BenLee" title="Documentation">📖</a></td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<!-- markdownlint-restore -->
|
|
|
|
|
<!-- prettier-ignore-end -->
|
|
|
|
|
|
|
|
|
|
<!-- ALL-CONTRIBUTORS-LIST:END -->
|
|
|
|
|
|
|
|
|
|
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
|
|
|
|
|