README_en.md

Это английская версия, см. README_ru.md для русской.

PoziTone

An extension for the Google Chrome, Opera, and other Chromium-based browsers that adds new features to your favorite online media players.

---

Table of contents

• Features
• Supported online media players
  • Supported via external modules
• Installation
  • For Opera
• Demo
• Keyboard shortcuts
  • Set up / change keyboards shortcuts
    • Demo: how to set up / change keyboards shortcuts
  • Global keyboard shortcuts (outside of the browser window)
• Gratitudes
• Credits
• Privacy
• Contribution
  • Spread the word
  • Translation
  • Incentive
• Feedback
• PoziTone on social networks

---

Features

• Displays info about now playing song, podcast, video, etc.

  Familiarizing with a new genre or band?

  PoziTone will show you track info (its name, artist name) via a pop-up notification on every track change.

• Easy player control outside of browser window

  Want to stop/resume playback, mute/unmute, switch track or add it to playlist?

  Three easy ways to do it:

  • Click a button in the pop-up notification.
  • Press keyboard shortcuts.
  • Or, just say a command^*!

  _{* (Voice control app PoziWorld Elf needs to be installed)}

• List of recently played

  What track played five minutes ago?

  PoziTone keeps information about the last 10 tracks played.

^{(back to table of contents)}

Supported online media players

• SoundCloud (full version of site)
• Google Play Music
• AudioAddict network:
  • ClassicalRadio.com
  • Digitally Imported (DI, DI.FM, or DI Radio)
  • JAZZRADIO.com
  • RadioTunes
  • ROCKRADIO.COM
• VK (audio, full version of site – old & new)
• VGM Radio
• Odnoklassniki (audio, full version of site)
• Online radio 101.ru (stations' main player)

More to come...

Supported via external modules

An external PoziTone module is a standalone extension which is able to provide PoziTone features by communicating directly with PoziTone behind the scenes.

• YouTube embedded player (for Opera).
• SoundCloud Widget (for Opera).
• Sovyatnik (for Opera).

Are you a developer? Want to add a support for your favorite player and publish it as a PoziTone module under your name? – Check PoziTone module SDK.

^{(back to table of contents)}

Installation

1. Go to a PoziTone in the Chrome Web Store page.
2. Click on “ADD TO CHROME”.
3. Then “Add extension”.

Done!

For Opera

1. Go to a PoziTone in the Opera add-ons catalog page.
2. Click on “Add to Opera”.

Done!

^{(back to table of contents)}

Demo

Go to SoundCloud and play any track.

PoziTone should display a notification with the track info.

^{(back to table of contents)}

Keyboard shortcuts

Preset

1. Alt+Shift+D — “Add to playlist”.
2. Alt+Shift+P — “Stop / Play”.
3. Alt+Shift+M — “Mute / Unmute”.
4. Alt+Shift+Q — “Show notification”.

Also available

Not preset, but can be easily set up with the help of next subsection.

5. Alt+Shift+F — “I like it!”.
6. Alt+Shift+N — “Next”.
7. Alt+Shift+B — “Previous”.
8. Alt+Shift+A — “Increase sound volume”.
9. Alt+Shift+Z — “Decrease sound volume”.
10. Alt+Shift+R — “Activate the extension”.

Set up / change keyboards shortcuts

1. Right-click on the PoziTone icon to the right of the address bar.
2. Click on “Manage extensions”.
3. Scroll down the page.
4. Click on the blue “Keyboard shortcuts” link.
5. Find PoziTone in the list.
6. Make any necessary changes.
7. Click on “OK”.

Demo: how to set up / change keyboards shortcuts

Global keyboard shortcuts (outside of the browser window)

By default, while the browser is not in the foreground, the shortcut will be inactive.

As of version 35 (Chrome), you can make the shortcuts work even when the browser is not in the foreground: see steps 1–7 above, change “In Chrome” to “Global” on step 6.

^{(back to table of contents)}

Gratitudes

• To all those who give us life and happiness!
• To the inspirers and testers of PoziTone: Darya, Evgeny, Mel, Nike, Sergey.
• UserEcho — for the excellent service, kindness and generosity!
• DreamHost — for the reliable hosting.
• Google, Inc. — for all their excellent projects.
• 101.ru — for a chance to listen to music for free and legally.
• Translators:
  • Spanish — Paco_Zamo (Francisco Zamorano);
  • Polish — jurczak (Łukasz Jurczak);
  • Italian — Aeco (Giuseppe Mariniello);
  • Ukrainian — ivan.zusko (Ivan Zusko).
  • Belarusian — natasmirnova1392 (Natalia Smirnova).

^{(back to table of contents)}

Credits

• The button icons — Gentleface Mono Icon Set, Gentleface, CC BY-NC 3.0.
• The Play icon — Michael Rowe, CC BY 3.0.
• The Info icon — Freepik from www.flaticon.com, CC BY 3.0.
• The appearance of the “PoziTone Options” and “Recent Tracks” pages:
  • Copyright 2014 The Chromium Authors. All rights reserved.
  • Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
• All trademarks used (trade names, logos, brands, names, service marks, etc.) are the property of their respective owners.

^{(back to table of contents)}

Privacy

This extension does not read, change, store, or transmit any of your personal data (e.g., logins, passwords, messages, contacts) from any of the sites or your computer in absolutely any form.

^{(back to table of contents)}

Contribution

Spread the word

If you find PoziTone useful, why not recommend it to your friends, colleagues, and/or followers?

There are a few ways you can help our cause:

• Follow us on Telegram, Facebook, Twitter, Google+, VK, Odnoklassniki, and Instagram.
• Share the installation link (for Opera) on your social networks and/or blog.
• Rate PoziTone (for Opera) – the feedback really helps others find this extension!

Translation

Sprechen Sie Deutsch? Vous parlez français?

We want as many PoziTone users as possible to be able to interact with the extension in their native language.

If you know any foreign language or just noticed a discrepancy in the translation, please let us know.

Incentive

If you appreciate the work we have done, please consider stimulating PoziTone development via PayPal, Square Cash, or Coinbase.

^{(back to table of contents)}

Feedback

We appreciate your feedback!

• Please share your ideas.
• Don't be shy to ask questions.
• Bug reports (for Opera) are valuable!
• We like praises (for Opera), who doesn't? :)
• Stick is helpful, but carrot is sweeter. ;)

^{(back to table of contents)}

PoziTone on social networks

• PoziTone on Telegram
• PoziTone on VK
• PoziTone on Twitter
• PoziTone on Facebook
• PoziTone on Google+
• PoziTone on Odnoklassniki
• PoziTone on 101.ru
• PoziTone on Instagram

^{(back to table of contents)}