{"id":6555,"date":"2021-01-04T18:21:43","date_gmt":"2021-01-04T18:21:43","guid":{"rendered":"https:\/\/manuals.qantumthemes.xyz\/onair2\/?post_type=ht_kb&#038;p=6555"},"modified":"2021-01-04T18:23:53","modified_gmt":"2021-01-04T18:23:53","slug":"11-3-server-type-shoutcast","status":"publish","type":"ht_kb","link":"https:\/\/manuals.qantumthemes.xyz\/onair2\/knowledge-base\/11-3-server-type-shoutcast\/","title":{"rendered":"11.03 Server type &#8211; Shoutcast"},"content":{"rendered":"<p>In this chapter you will learn <strong>how<\/strong>\u00a0<strong>to correctly set up your Shoutcast channel to display the song titles and artist information.<\/strong><\/p>\n<p>If you are unsure about your type of server,\u00a0<strong>you should ask your streaming provider<\/strong>.<\/p>\n<p>We know this explanation may result a bit long and articulated,<strong>\u00a0but setting up a streaming source is not always straight forward<\/strong>, because there are no strict standards, and every provider has tiny little differences<strong>, so we will cover any possible case and guide you through the process<\/strong>.<\/p>\n<p><strong>IMPORTANT!<\/strong>\u00a0Please remember that you can&#8217;t play the stream or display the titles from an HTT<strong>P<\/strong>\u00a0stream if your website uses the HTTP<strong>S\u00a0<\/strong>protocol.<\/p>\n<h2 id=\"how-to-set-a-shoutcast-radio-channel\" >How to set a Shoutcast radio channel<\/h2>\n<p><strong>Step 1:<\/strong>\u00a0In your WordPress Admin, under Radio Channels, create or edit your\u00a0<strong>Radio channel.<\/strong><\/p>\n<p><strong>Step 2:<\/strong> make sure Metadata is NOT selected.<\/p>\n<p><strong>Step 3:<\/strong> Make sure your <strong>Shoutcast<\/strong> version is at least 2.<\/p>\n<p><em><strong>Important:<\/strong>\u00a0Shoutcast\u00a0<strong>V1<\/strong>\u00a0is not supported as is dismissed since 16 years and is highly insecure. If you have a Shoutcast\u00a0<strong>V1<\/strong>\u00a0server, you can use the Metadata instead, but please be aware that Shoutcast V1 is highly insecure.\u00a0<a href=\"https:\/\/en.wikipedia.org\/wiki\/SHOUTcast\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>More info<\/strong><\/a><\/em><\/p>\n<h3 id=\"what-is-my-shoutcast-version\" ><strong>What is my\u00a0<em>Shoutcast<\/em>\u00a0version?<\/strong><\/h3>\n<p>The version of your\u00a0<strong>Shoutcast<\/strong>\u00a0is written on the top right corner of your Shoutcast page<\/p>\n<p><a href=\"https:\/\/pro.radio\/shop\/manual\/shoutcast-version.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-537\" src=\"https:\/\/pro.radio\/shop\/manual\/shoutcast-version.png\" alt=\"\" width=\"786\" height=\"377\" \/><\/a><\/p>\n<p>To set a Shoutcast channel, you will need the following fields:<\/p>\n<p><a href=\"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-6556\" src=\"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration.jpg\" alt=\"\" width=\"1280\" height=\"573\" srcset=\"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration.jpg 1280w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-300x134.jpg 300w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-1024x458.jpg 1024w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-768x344.jpg 768w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-50x22.jpg 50w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-920x412.jpg 920w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-600x269.jpg 600w, https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-content\/uploads\/2021\/01\/shoutcast-radio-channel-configuration-320x143.jpg 320w\" sizes=\"(max-width: 1280px) 100vw, 1280px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>So, if your Shoutcast URL is for instance<\/p>\n<p><strong>http:\/\/5.135.191.40:8000\/<\/strong><\/p>\n<p>The<strong> MP3 stream URL is \/stream<\/strong><\/p>\n<p>http:\/\/5.135.191.40:8000\/stream<\/p>\n<p>To display the titles:<\/p>\n<ol>\n<li><strong>Host<\/strong>: 5.135.191.40 (\u00a0<strong>without<\/strong>\u00a0http:\/\/ )<\/li>\n<li><strong>Port<\/strong>: 8000<\/li>\n<li><strong>Protocol<\/strong>: default or automatic<\/li>\n<li><strong>Channel<\/strong>: by default is 1, but you can specify another number if you have a multi-channel Shoutcast. To know your channel number, you should copy your<strong>\u00a0Shoutcast json data<\/strong>\u00a0(more info below) on the website http:\/\/jsonviewer.stack.hu\/ and click &#8220;Viewer&#8221;, it will display the content in a readable format, where you can chount the channels and find your ID. Please remember that the first channel ID is 1 (not 0).\u00a0<strong>In alternative, ask to your streaming provider.<\/strong><\/li>\n<\/ol>\n<h3 id=\"how-to-verify-your-shoutcast-url-and-information\" >How to verify your Shoutcast URL and information:<\/h3>\n<p>There is a standard URL used by Shoutcast to display the Json information (only Shoutcast 2 and above) which is the following:<\/p>\n<pre>http:\/\/[your server url and post here]\/<strong>stats?sid=1&amp;json=1<\/strong><\/pre>\n<p>In the example above, &#8220;<strong>sid<\/strong>&#8221; is the\u00a0<strong>Streaming ID,<\/strong>\u00a0which is 1 by default but can be another number in case of multi-channel streams.<\/p>\n<p><strong>The parameter &#8220;json=1&#8221;<\/strong>\u00a0instead loads the Json formatting, which is much faster than the old XML and gives you a better performance.<\/p>\n<p><strong>So, you can usually copy<\/strong><\/p>\n<pre>\/<strong>stats?sid=1&amp;json=1<\/strong><\/pre>\n<p>and\u00a0<strong>paste it after your streaming page URL<\/strong>. The result should be something like this:<\/p>\n<p><a href=\"https:\/\/pro.radio\/shop\/manual\/shoutcast-json-example.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-538\" src=\"https:\/\/pro.radio\/shop\/manual\/shoutcast-json-example.png\" alt=\"\" width=\"1139\" height=\"249\" \/><\/a><\/p>\n<h3 id=\"verify-your-json-data\" >Verify your json data<\/h3>\n<p>It rarely happened to find radio channels with a broken &#8220;json data&#8221;. This means that the URL &#8220;stats&#8221; opens the json but it is unreadable, returning a console error.<\/p>\n<p>To verify if your JSON is correctly formatted, copy the code in the website\u00a0<a href=\"http:\/\/jsonviewer.stack.hu\/\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/jsonviewer.stack.hu\/<\/a><\/p>\n<p><a href=\"https:\/\/pro.radio\/shop\/manual\/Verify-json.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-542\" src=\"https:\/\/pro.radio\/shop\/manual\/Verify-json.png\" alt=\"\" width=\"1017\" height=\"308\" \/><\/a><\/p>\n<p>Then click &#8220;Viewer&#8221;<\/p>\n<p><a href=\"https:\/\/pro.radio\/shop\/manual\/viewer.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-543\" src=\"https:\/\/pro.radio\/shop\/manual\/viewer.png\" alt=\"\" width=\"174\" height=\"48\" \/><\/a>You should see something like this:<\/p>\n<p><a href=\"https:\/\/pro.radio\/shop\/manual\/json-viewer.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-544\" src=\"https:\/\/pro.radio\/shop\/manual\/json-viewer.png\" alt=\"\" width=\"479\" height=\"746\" \/><\/a><\/p>\n<p><strong>If instead you see an error, like this:<\/strong><\/p>\n<p><a href=\"https:\/\/pro.radio\/shop\/manual\/json-error.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-545\" src=\"https:\/\/pro.radio\/shop\/manual\/json-error.png\" alt=\"\" width=\"373\" height=\"244\" \/><\/a><\/p>\n<p>it means that your JSON formatting is broken, and this is usually caused<strong>\u00a0by a software error on your streaming server<\/strong>. You should take some screenshots and<strong>\u00a0contact your streaming provider<\/strong>, asking\u00a0<strong>them<\/strong>\u00a0to fix it.<\/p>\n<h3 id=\"force-https-option\" >Force HTTPS option:<\/h3>\n<p>This option is required\u00a0<strong>for the providers allowing HTTPS connection on non-standard ports.<\/strong><br \/>\nUsually, the only HTTPS port is 443. But, if your Shoutcast has\u00a0<strong>HTTPS on some custom port as 15550<\/strong>\u00a0or\u00a0<em>anything<\/em>\u00a0else other than 443, and you are sure that the HTTPS connection is there, then use the \u201cforce https\u201d setting.<\/p>\n<p>Otherwise, the player will automatically use\u00a0<strong>HTTPS<\/strong>\u00a0for the\u00a0<strong>443<\/strong>\u00a0port, and\u00a0<strong>HTTP<\/strong>\u00a0for any other.<\/p>\n<h3 id=\"troubleshooting\" >Troubleshooting:<\/h3>\n<ol>\n<li>If your\u00a0<strong>website<\/strong>\u00a0is\u00a0<strong>HTTPS<\/strong>\u00a0and your stream is\u00a0<strong>HTTP<\/strong>, you generally\u00a0<strong>cannot<\/strong>\u00a0display titles,\u00a0<strong>nor listen to the music.\u00a0In this case you may want to put the site in http or change streaming provider.<\/strong><\/li>\n<li>If your stream is HTTP<strong>S<\/strong>, your website is HTTP<strong>S<\/strong>\u00a0and your shoutcast page is\u00a0<strong>HTTP,\u00a0<\/strong>you generally cannot display titles without using a proxy. It would be much better if you use a streaming provider that gives you HTTPS access, but you can also try our proxy (enable the proxy in the Customizer settings, under the Radio section)<\/li>\n<li>If the <strong>proxy<\/strong> doesn\u2019t work either, please ask your website\u00a0<strong>hosting<\/strong>\u00a0provider (where you bought your domain and\/or hosting) to make sure that your website can connect, server side, to the port of the shoutcast channel.In the example above, the\u00a0<strong>channel<\/strong>\u00a0is\u00a0<strong>8000<\/strong>, so you need to verify with your\u00a0<strong>website server provider<\/strong>\u00a0that your site can connect, server side via cUrl, using the port 8000.<\/li>\n<li>If your\u00a0<strong>streaming provider<\/strong>\u00a0has an\u00a0<strong>HTTPS<\/strong>\u00a0stream but the certificate is\u00a0<strong>invalid<\/strong>, your browser will refuse the connection, for obvious security restrictions.\u00a0<strong>You can verify this condition by opening the https url of your Streaming page on the browser.<\/strong><\/li>\n<li>If you need help setting up your radio,\u00a0<strong>please contact our helpdesk.<\/strong><\/li>\n<li>As last resource, you can use the\u00a0<strong>Metadata<\/strong>\u00a0server type instead of Shoutcast.<\/li>\n<\/ol>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht_kb_category":[654],"ht_kb_tag":[656,558,660,560,659],"class_list":["post-6555","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-radio-streaming-channel-set-up","ht_kb_tag-channel","ht_kb_tag-radio","ht_kb_tag-setup","ht_kb_tag-shoutcast","ht_kb_tag-titles"],"_links":{"self":[{"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/ht_kb\/6555"}],"collection":[{"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/comments?post=6555"}],"version-history":[{"count":2,"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/ht_kb\/6555\/revisions"}],"predecessor-version":[{"id":6578,"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/ht_kb\/6555\/revisions\/6578"}],"wp:attachment":[{"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/media?parent=6555"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/ht_kb_category?post=6555"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/onair2\/wp-json\/wp\/v2\/ht_kb_tag?post=6555"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}