Troubleshooting
===============

Software is made by imperfect humans and thus tends to reflect that reality.  Here are
some tips and tricks to help you out:

* Experience has shown that starting the **What's Now Playing** app as the first piece of
  software in your stack generally results in a better experience. So, for example:

  1. **What's Now Playing**
  2. Virtual DJ
  3. OBS

  By the time OBS is up, **What's Now Playing** and your DJ software should have performed their
  housekeeping tasks.

* Be sure to remember to shut down **What's Now Playing** between sessions.  Because it hangs out
  in the menu bar, it is easy to forget it is running!

* Don't forget that there is delay from when your computer starts playing a song and
  when it finally makes it on-stream.  There are also delays between different devices
  in how the receive content.  For example, Apple TV devices may be up to a minute
  after you streamed your track!

* You do not need to be streaming to participate in your channel's Twitch chat. This
  fact means that **What's Now Playing** can be running and sending track information to
  Twitch but your users won't be alerted.  Extremely useful for working out the
  aforementioned timing issues.

* Check the current `Bug List <https://github.com/whatsnowplaying/whats-now-playing/issues?q=is%3Aissue+is%3Aopen+label%3Abug+sort%3Aupdated-desc>`_ to see if any known problems apply
  to your situation.