Learn a song

Yes, BardWay has a Learn feature. It is a format where viewers drop songs that are not in your repertoire into a song jar and vote for them. You start a collection, and at the end you wrap up with a draw weighted by votes or by picking the winners yourself. You learn the chosen songs and play them on stream.

How it works

  1. You turn on Learn in the settings and open a song collection.
  2. Viewers suggest songs (artist + title) and vote for them. A vote can be free or paid with a donation, depending on your settings.
  3. The collection runs. You can set a timer, and then the collection closes by itself. Without a timer it runs until you stop it.
  4. You wrap up, either at random weighted by votes or by hand.
  5. The chosen songs appear on the page marked "in progress", and once you have learned them, "learned". Past collections stay on the "Learned before" shelf.

How to turn it on

  1. Open Settings → Song learning.
  2. Turn on the The Learn page toggle. While it is off, the page is not in the menu and not reachable by a direct link.
  3. Set the collection conditions and open a collection on the Learn page.

Collection settings

Jar and winners

  • Songs per round: how many songs fit in the jar. When the jar is full, new songs are not accepted, but the ones already suggested can still be voted for.
  • Winners: how many songs win. No more than the songs in the jar.
  • Default timer, hours: 0 means "no timer". You can change the time when you start the collection.

How the winner is chosen

  • Random, weighted by votes. The more votes a song has, the better its chances. You or an admin run the draw with a button on the Learn page.
  • I pick the winners. You mark the winners yourself, and the votes help you decide.

Who can vote

  • Signed-in viewers only: one account, one voter, fairer results. It applies to both free votes and donation votes.
  • Open voting: anyone can vote, even without signing in to the site. More people vote, but one person can vote several times from different devices and browsers.
  • Viewers can suggest their own songs. Turn it off if you or your admins put songs in the jar and viewers only vote. You and your admins vote without limits.
  • From live learn. A song that did not work out on stream can be sent to the jar of an open collection with Send to «Learn a song» in the "⋯" menu of its row in the Live learn table. It goes into the jar as your suggestion.

Free votes

Each viewer can support a few songs for free. You set how many free votes a viewer has per collection. One vote goes to one song.

Donation votes

A viewer sends a donation with a vote code, and the vote counts when the donation arrives. A donation of at least the price of a vote equals one vote, and a larger amount still counts as one vote.

For donation votes to work, connect a donation service on the Account page. Without a donation link viewers will not see this option.

Votes for coins

If you have activities and "Donation votes" turned on, a signed-in viewer with an open coin box can pay for a vote with a minted coin instead of a donation while a collection is running. You set the price in coins in Settings → Activities → Shop and prices, where there are two items.

  • Paid vote in Learn a song: the same as a donation vote, only paid with a coin. It is one vote for one song.
  • Extra vote in Learn a song: one more vote for a different song on top of the free ones. You set how many such votes a viewer can have per collection in the same place (one by default).

Paying with a coin does not need a donation code and does not add money to the donation total. On the Learn page such votes are marked with a coin icon and counted separately from donations: on the statistics tile, for a song and for a voter. For the collection it is the same paid vote, but it brings in no money. The owner and admins do not need to pay: their votes are free.

Coins are returned to the viewer automatically when you exclude a song or cancel the collection on the Learn page. If you bring an excluded song back with the Restore button, the vote counts again, and the coins are not charged a second time.

Rewards for votes

The activities rules reward viewers in Learn as well:

  • A vote in Learn a song (10 coins by default): once per collection to a signed-in viewer, when their vote is counted. A guest's vote earns no coins. A vote held by banned words earns them after you admit it. Paid votes (both for a donation and for a coin) are rewarded the same way.
  • A win in Learn a song (off by default, 5 coins): everyone who voted for the song that won the draw gets the reward when you wrap up.

These rules work while the Learn block is on. You turn them on in Settings → Activities.

Results on stream (OBS)

The draw you run on the Learn page can appear right on stream: viewers see the animation and the winners, and the buttons stay with you on the site.

  1. In Settings → Song learning → Results on stream, turn on Show the results in OBS.
  2. In OBS, connect the main overlay link All blocks: queue, draw, events and roulette from Settings → Overlay: the results window is part of it.
  3. The window's place on the screen, margins and width are set there too, in Position on screen (top left by default). The Learn page no longer has a position setting.

The link is personal, do not show it on stream. All links use one key for the whole channel. If you need the results window as a separate source, the More: separate links per block section on the overlay page has a Learn draw results only link: it works the old way and ignores the position from the layout. More: OBS overlay.

Banned words

Songs whose artist or title contains words from your list do not go into the jar right away. The list is shared by the whole channel and is edited in Settings → System, in the Banned words card (words separated by a comma, a semicolon or a new line). Live learn uses the same list. You check such songs first, on the Needs action tab of the Learn page: admit, fix or exclude them. Until you decide, votes for such a song do not count, and viewers do not see it.

Part of a word is also searched inside other words. Letter case, look-alike letter substitutions, stretched letters and spelling with dots do not get around the check. Your votes and your admins' votes are not checked.

FAQ

Can I learn songs on BardWay by viewer request?

Yes. The Learn feature collects song suggestions and viewer votes, and at the end you wrap up and learn the chosen songs.

How do viewers vote for a song?

For free (within the per-collection vote limit), with a donation, or with a minted coin if you have activities on. A donation of at least the price of a vote is one vote. You configure what exactly is available.

Will coins be returned if I exclude a song?

Yes, if the vote was paid with a coin. Coins are returned when a song is excluded, when a collection is cancelled, and at the draw for songs that were still "under review". The reward for the vote itself stays with the viewer.

Who picks the song, me or chance?

As you set it up. You can run a random draw weighted by votes, or pick the winners by hand.

Can viewers suggest songs themselves?

Yes, if Viewers can suggest their own songs is on. If you turn it off, you and your admins put songs in the jar, and viewers only vote.

How do I show the draw on stream?

Turn on Show the results in OBS and connect the main link from Settings → Overlay in OBS. Details are above.