Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thom4parisot/webextension-fip
Minimalistic WebExtension to listen to FIP Radio, the best eclectic radio station (for Firefox, Chrome, Opera and Edge)
https://github.com/thom4parisot/webextension-fip
angular-app chrome-extension fip fip-radio firefox-addon lastfm opera-extension radio-station webextension webextensions
Last synced: 3 months ago
JSON representation
Minimalistic WebExtension to listen to FIP Radio, the best eclectic radio station (for Firefox, Chrome, Opera and Edge)
- Host: GitHub
- URL: https://github.com/thom4parisot/webextension-fip
- Owner: thom4parisot
- License: mit
- Created: 2013-04-24T12:37:34.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2023-01-08T20:48:51.000Z (about 2 years ago)
- Last Synced: 2024-04-12T15:05:40.625Z (9 months ago)
- Topics: angular-app, chrome-extension, fip, fip-radio, firefox-addon, lastfm, opera-extension, radio-station, webextension, webextensions
- Language: JavaScript
- Homepage: https://chrome.google.com/webstore/detail/fnhlecpfnocgmmmghkjcipmhdpmpddii
- Size: 5.28 MB
- Stars: 33
- Watchers: 3
- Forks: 10
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.en.md
- License: LICENSE
Awesome Lists containing this project
README
# FIP Radio — for Chrome, Firefox, Edge and Opera web browsers ![][status badge] ![][rating badge] ![][downloads badge] ![][version badge]
> Listen to [FIP Radio](https://www.fip.fr/) in a minimalistic browser interface.
> FIP is an eclectic and ad-free radio station.
> Optionnally scrobble tracks to your last.fm account.
Oh, and it's **ads free** and **trackers free**.
Check the [privacy policy](PRIVACY_POLICY.md) to know more how first-parties (aka. _not me_) may collect data about you.
I developed this extension to listen to my favourite radio station when [I moved from France to London](https://thom4.net/2013/every-day-is-a-brand-new-place/).
# Features
| One-click playback, volume control and song preview | Get to know what aired previously |
| --- | --- |
| ![][img-now] | ![][img-history] |
| Select a station | Scrobble to last.fm |
| --- | --- |
| ![][img-stations]| ![][img-lastfm] |
# Install in your browser
You are **one click away** from installing the extension in your favourite web browser.
_FIP Radio WebExtension_ is distributed on the official web stores:
* Firefox: [via Firefox Add-ons][Firefox extension]
* Chrome: [via the Chrome Web Store][Chrome extension]
* Opera: [via the Chrome Web Store][Chrome extension]
* Edge: [via the Chrome Web Store][Chrome extension]
Once installed, the radio playback is accessible by clicking on the FIP logo, freshly added to your browser.
That's it!
# Contribute
Contributions are friendly welcomed, either they are code, ideas or bug reports.
The developer toolchain relies on:
- [Angular](http://angularjs.org/) for dynamic HTML templating;
- [Machina.js](https://github.com/ifandelse/machina.js) for State Machine management;
- [WebExtensions API](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions), to embed, run and distribute this browser extension.
If you don't know them much… well it's a good occasion to learn!
## Development Setup
Better for you to have [https://nodejs.org/download/](Node.js) (v10+) installed on your computer to use the development tooling.
Hit the `Clone or download` button above to get a copy of the source code. Then run these commands in a terminal:
```bash
$ npm install
$ npm run watch
```
Then load the **unpacked extension** or **temporary module** in your browser by typing a special URL:
| Firefox | Chrome
| --- | ---
| `about:debugging#/runtime/this-firefox` | `chrome://extensions/` |
|  |  |
The browser will ask you to **locate the `manifest.json` file**.
After being loaded, any change in the source code will be taken in account immediately ⚠️ **except background page code** — which requires to hit the related `Refresh` or `Reload` button in the extension panel.
[Chrome Dev Tools](https://developers.google.com/chrome-developer-tools/) will
help you debugging by displaying errors or the various state change of the playback.
## Testing
Tests partially assert the code works as expected. You can check on your own:
```bash
$ npm test
```
If you don't think about it, no problem, tests are automated when you contribute back your code.
You will receive help and guidance if adding new tests is necessary.
Current status is pretty poor but the codebase is solid.
# Privacy Policy
[Read the end user privacy policy](PRIVACY_POLICY.md).
> tl;dr no data is collected.
# License
[MIT license](LICENSE).
[Chrome extension]: https://chrome.google.com/webstore/detail/fnhlecpfnocgmmmghkjcipmhdpmpddii
[Firefox extension]: https://addons.mozilla.org/firefox/addon/fip-radio/
[status badge]: https://github.com/thom4parisot/webextension-fip/actions/workflows/release.yml/badge.svg
[downloads badge]: https://img.shields.io/chrome-web-store/d/fnhlecpfnocgmmmghkjcipmhdpmpddii.svg
[version badge]: https://img.shields.io/chrome-web-store/v/fnhlecpfnocgmmmghkjcipmhdpmpddii.svg
[rating badge]: https://img.shields.io/chrome-web-store/rating/fnhlecpfnocgmmmghkjcipmhdpmpddii.svg
[img-now]: resources/screenshots/popup-now-playing.png
[img-history]: resources/screenshots/popup-relative-buffering.png
[img-stations]: resources/screenshots/options-stations.png
[img-lastfm]: resources/screenshots/options-logged-in.png