This is the documentation for Beam. This documentation is aimed to have all information about the current release. For older releases you can find an offline copy in Beam itself.
As this is the first release of Beam, we do not have changelog. Instead we consider all features as new!
Also have a look into our FAQ for questions often asked.
Each platform require different installation scenarios, please refer to the Downloads-page for specific platforms.
After installing Beam you need to set which media player to connect to. This is done in the preferences.
Under Basic settings, Media player, select your media player. Now you are good to go!
The main interface
The main window of Beam will display your songs. When using Beam at a milonga, simply open Beam (which you have configured). Move it to the projector or external screen, and set it to full screen.
Scaling and fullscreen
As a window, Beam is scaled by dragging the boarders of the window. Beam can be set to full screen by double-clicking in the window or F11. Beam can scale to 4:3, 16:9, 16:10 or any dimensions of your projector or screen.
All settings for Beam is configured from the preferences.
The basic settings control how to retrieve song information from the media players and some look- and feel-information.
In Layout menu you configure what to display in Beam. This is done with a combination of static text and tags. A list of all tags available in Beam can be found here.
Cortinas and Rules
Under Cortinas and Rules you set up how Beam will find cortinas and parse information the tags. As Beam is intended for tango, we have created an additional tag which is not present in the ID3-tags, %Singer. Intention is to fill this with information such as name of singer or instrumental. See below.
In the Cortinas and rules you can add, remove, edit, toggle rules to be active or inactive.
There are three types of rules in Beam:
Copies a value from one field to another. This is very useful for %Singer this information probably is stored in some other tag in your files.
This rule is used to handle combined tags. Tags containing for example “Nada – Alberto Podestá” can with the rule below be separated into %Title and %Singer.
Detecting cortinas are vital to be able to detect the next tanda. Beam is able to show information about the next tanda, only if the cortina is detected in the playlist. This feature is dependent on which media player you are using. See the feature-list for more info about this.
For moods settings, see separate section here.