Setting up the widget - songify-rocks/Songify GitHub Wiki

How to Use the Widget Generator and Create a Widget

The widget generator in Songify allows you to create a customizable widget for displaying the current song in OBS or other broadcasting software. Follow these steps:

  1. Open the Widget Generator

    • In Songify, click on File -> Widget.
    • This will open the widget generator website in your browser.

  2. Enable Song Info Upload (if prompted)

    • If the option to upload the song info is not already activated, Songify will ask you to enable it.

  3. Customize the Widget

    • The Song Upload URL field will be populated automatically. Do not change this value.
    • Use the various options in the widget generator to customize the look and feel of your widget:
      • Rounded Corners: Adjust the corner radius of the widget.
      • Icon Position: Choose the position of the icon (e.g., left or right).
      • Scroll Direction: Set the text scroll direction (e.g., right-to-left or reverse).
      • Transparency: Adjust the transparency of the widget background.
      • Scroll Speed: Customize the speed of the scrolling text.
      • Use Album Cover: Toggle whether the album cover is displayed.
      • Use Canvas (if available): Enable Spotify Canvas clips if available for that song.
      • Show/Hide on Song Change: Toggle whether the widget appears only when a new song starts playing.
      • Show/Hide Animations: Customize fade-in and fade-out animations and their duration.

  4. Copy the Widget URL

    • Once you're satisfied with your customization, copy the URL shown below the widget preview.

  5. Add the Widget to OBS

    • Open OBS Studio and add a Browser Source.
    • Paste the copied URL into the URL field.
    • Set the dimensions of the browser source to:
      • Width: 312 px
      • Height: 64 px

  6. Test the Widget

    • Play a song in Songify and ensure the widget updates and displays correctly in OBS.

Additional Notes:

  • The Song Upload URL is pre-configured and should not be changed.
  • If the widget does not display correctly, ensure that the song info upload is activated in Songify.
  • Customize the dimensions in OBS if you need a different widget size, but the recommended size is 312x64 px for optimal display.

Feel free to experiment with the settings to create a widget that matches your stream's style!