Coder Social home page Coder Social logo

michaelstonis / beardie Goto Github PK

View Code? Open in Web Editor NEW

This project forked from stillness-2/beardie

0.0 1.0 0.0 61.83 MB

Beardie is a utility that allows you to control various media players with your keyboard.

Shell 0.93% JavaScript 10.13% Ruby 0.11% C 0.66% Objective-C 81.15% Swift 7.00% HTML 0.03%

beardie's Introduction

Announcement

At the moment I do not build releases with fixes, as there is no possibility to notarize the application (my personal subscription to Apple Developer Program expired). :) But you can take sources from master branch and build the application by yourself.

At this stage, I do not need to renew my Apple Dev subscription, and this $100 is a significant amount for me.

I can try to collect $100 through donates, if someone needs new release of the application. :)

Donation link: https://destream.net/live/vityevato/donate

Intro

Beardie is a utility that allows you to control various media players with your keyboard. It is a fork of the BeardedSpice project.

It allows you to manage web based players (SoundCloud, YouTube ... List of supported sites to date), native application players (Apple Music, Spotify ...) and Sonos systems.

Beardie is more than just play/pause, it has some additional controls that add to the convenience. You can keep several player applications open, and several tabs of several browsers with web players, since Beardie "understands" what exactly you want to control at the moment. :) It also allows you to easily switch between running (open) players.

Users Guide

Beardie

Install

Mac OS X 10.15 or greater required.

You can download the latest release here, or find a full list of all our previously released binaries here.

In order for the Beardie to control web players, you need to enable the Enable Browser Extensions option in the General tab of the Beardie Preferences (available through the menubar icon).

Extensions

The Beardie will offer to install a self-signed certificate in the keychain, this certificate will be used to encrypt the exchange between the application and the extensions. The exchange takes place over the WebSockets over SSL/TLS protocol.

You should also install the extension in the browser you are using.

Get Extensions

The Google Chrome extension can be installed in other browsers that support extensions from the Chrome extension store, and most likely everything will work as expected. :)

Features

Supports media keys

Beardie supports players control with standard media keys of an Apple keyboards.

Smart Mode

Beardie tries to automatically guess which player it should control for you. When you press any Beardie shortcut or media key with Beardie open, it will automatically control the site (native app) currently playing media, if you have no playing player, it will try to control the browser tab (if it is one of our supported sites) or native player app, which is currently focused, if Beardie failed to do either, it will automatically control the first.

Keyboard Shortcuts

Beardie comes with a handy list of Keyboard Shortcuts that can be configured under the Shortcuts tab of the Beardie Preferences. Here is a default settings:

Keyboard Shortcuts

Very usefull command is Raise/Hide Active Player Window. For example, you are working with a document, and you are tired of the current playlist, which is playing from the site on one of the tabs in some browser window. Press the combination and Beardie will bring up the browser window and switch to the player tab. Change the playlist and press the combination again. Beardie will take you back to the document window, while restoring the sequence of windows and tabs in the browser as it was before.

If you are like me, love music, listen to it from different sources and cannot decide on the player :), then for sure you will have several players open at the same time. For this case, there are the Players Switching Shortcuts. They allow you to switch between open players. If you want to "look around", then before switching, execute the Raise/Hide Active Player Window command to raise the current player up, then switch between the players to the desired one, while each new current player will be raised up, re-execute Raise/Hide Active Player Window, to get back to work.

If the smart mode does not work properly, you can force the player to be active. To do this, use the Set Active Player Window command.

Automatic Updates

Beardie will automatically notify you when a new release is available.

Up to Date Media Strategies

First, what is a Media Strategy? This is what we call a template with custom javascript aimed at a specific website, allowing the Beardie program to control it with the media keys.

Second, the Compatibility Updates option allows you to check for added or changed Media Strategies that were contributed since the last official release.

You can also exchange strategies between users in the form of files with the extension bsstrategy. In the application Preferences, in the Controllers section there are corresponding Export/Import buttons. There is a repository with untested strategies.

Supporting BeardedSpice Strategies

Since Beardie is a fork of BeardedSpice it fully supports the strategies created for BeardedSpice. There is also a convenient add/update function from Unsupported BeardedSpice Strategies repository. Use Unsupported Web Strategies section in settings.

Controllers

Disabling certain handlers

From the Controllers preferences tab, uncheck any types of webpages that you don't want Beardie to have control over. By default, all implemented handlers are enabled.

Supported Mac OS X applications

Supported Sonos players

Supports Sonos players, which are detected in local network.

Supported Browsers

Supported Sites

The list of supported sites often changes, the current state of affairs can be found on this page, which is automatically generated.

Don't see your favorite site in the list?

Check, may be already exists a strategy, in the repository with untested strategies

beardie's People

Contributors

ahanriat avatar andrewslotin avatar anthonywhitakerjr avatar askedrelic avatar bretmartin avatar breyten avatar coder-256 avatar conarro avatar davarisg avatar egoberdon avatar febbraro avatar fmborghino avatar foozee avatar frdmn avatar gapurov avatar geexican avatar jayrhynas avatar jhuebsch avatar jmcouillard avatar josefalcon avatar kureb avatar markreid avatar okcoker avatar ploddi avatar pnamu avatar ponomarevlm avatar stillness-2 avatar tanmaysachan avatar trhodeos avatar vitorgalvao avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.