Difference between revisions of "Hyperradio js OXP"

From Elite Wiki
m
m (New version)
Line 1: Line 1:
 
[[Image:Hyperradio.png|frame|right|150px]]
 
[[Image:Hyperradio.png|frame|right|150px]]
{{OXPConfig-large}}
+
 
===OVERVIEW===
+
===STORY===
 
----
 
----
Trading goods between worlds is an extremely dangerous and hard job and a commander will need some relaxing moments. Listen to your radio station and enjoy Jazz, Folk, HardRock or whatever you like (and whatever is available). Use one station for all systems or expand it, so you will get different programs in different systems. You can even add your own music to the playlist. So rip your CDs, download songs, or install one or more of the available [[Hyperradio_Musicpacks|musicpacks]]. Everything is possible. For more information about  creating your own [[Hyperradio_Musicpacks|musicpacks]] take a look in a short guide [[Hyperradio_Howto_Musicpacks|HowTo make a own station]].
+
Trading goods between worlds is an extremely dangerous and hard job and a commander will need some relaxing moments. Listen to your radio station and enjoy Jazz, Folk, Rock or whatever you like. Use one station for all systems or expand it, so you will get different programs in different systems. You can even add your own music to the playlist. So rip your CDs, download songs, or install one or more of the available [[Hyperradio_Musicpacks|musicpacks]]. Everything is possible - and travelling will be much more fun - even 'milkruns' won't be boring business anymore. And with the capacity to be expanded by other users creating their own [[Hyperradio_Musicpacks|musicpacks]] it will always be the right investment.
 +
 
 +
Adding own songs to the main playlist of the HyperRadio is simple. Please note that only ogg-vorbis is supported by Oolite.
  
This device connects your ship-systems to the [[Hyperradio_Musicpacks|HyperRadio stations]]. By sending it's ID your ship receives a coded hyperwave that is stored into the integrated memory. You are licensed to use this device for a period of 20 days. When the time is expired, you should make a short break at your local dealer for a new license. Long journeys will become a lot more fun...
+
1. Just place your soundfiles in the OXPs Music-folder.<br>
 +
2. Open hyperradio.js in the Scripts-folder (you can use a simple text-editor) and add your filenames to the array.<br>
 +
Example:
 +
  this.playListOriginal = new Array(
 +
    "Rage-Back_in_time.ogg",
 +
    "Stevie_Ray_Vaughan-Voodoo_Child.ogg"
 +
  );
 +
Save your additions. That's it.
 +
3. Fire up Oolite and buy the Hyperradio license (it is not everywhere available).
 +
# - Launch from the station and step to the F7 - SYSTEM_DATA_SCREEN.
 +
# - When the connection is stable (the music is playing) step back to the cockpit-view (F1).
 +
# - When the song is over... F7, back to F1,...
  
Using IN_GAME_MUSIC is a special thing. Currently it is possible to use the Ogg-Vorbis (.ogg) and Wave (.wav) -format (see table below). This file should not contain more than two channels, because Oolite does not support any surround-audio-files. It seems that Oolite reduces these files to stereo. And various kbps are handled by using a average kbps-rate. <b>This oxp supports only Ogg-Vorbis files!</b>
+
To get some more complexity it is possible to use different 'stations' with different playlists. There are a few [[Hyperradio_Musicpacks|station-musicpacks]] already available for you.
  
The background music '''max''' db should be between -10 and -6 db, because a lot of players are using customsound-OXPs and the player should hear if something happens. And the new functionallity of Oolite will cause that more and more OXPs will use their own sounds. That means that sounds (like laser fire) should be between -6 and -3 db at a max. Higher values can result in digital clipping, but if you are familiar with mastering you can use higher values, but better not.
+
If you are using one or more of the available [[Hyperradio_Musicpacks|musicpacks]] the Hyperradio chooses a playlist based mainly on the system.ID, but it depends also on the number of installed [[Hyperradio_Musicpacks|musicpacks]] and in some cases it gets a random chance of changing the radio station.
<br>
+
 
===LATEST FEATURES===
+
Documentation about creating own stations is available at the [[Hyperradio_Howto_Musicpacks|HowTo make a own station]] page.
 +
 
 +
===OVERVIEW===
 
----
 
----
* Since v1.10 the Hyperradio is compatible to [[OXPConfig]] and supports additional functions like a station randomizer and a switch for eventmusic.
+
{{OXPConfig-small}}
* And with v1.12 it is also compatible with [[Repair_Bots|Repair Bots]].
+
The HyperRadio is your personal tool for playing music in the game. Before it was a bit tedious to run other applications (like Winamp) for this case, because these music-players are not really connected to Oolite and the user doesn't have control about it (or has to switch to this application). The HyperRadio jumps in here to play your songs and reacts on changes in Oolite.
  
===HANDLING===
+
Additionally it is compatible and configurable via [[OXPConfig]] and [[Repair_Bots|Repair Bots]].
----
 
* Step 1: Just place your soundfiles in the <b>OXPs Music-folder</b>.<br>
 
Please note that the versions before v1.05 have used the Sounds-folder. If you have your soundfiles already there, just rename the folder or copy/move the files in the Oxps Music folder.<br>
 
* Step 2: Open <b>hyperradio.js</b> in the <b>OXPs Scripts-folder</b> (you can use a simple text-editor) and add your filenames to the array or override the existing ones.<br>
 
Example:<br>
 
  this.playListOriginal = new Array(
 
    "Rage-Back_in_time.ogg",
 
    "Stevie_Ray_Vaughan-Voodoo_Child.ogg"
 
  );
 
  
Please note that the last entry does not have a commata at the end.
+
Features:
Save your additions. That's it. Totaly easy.
+
* Extended logging
* Step 3: Fire up Oolite. Buy the HyperRadio (it is not everywhere available), launch from the station and go to the SYSTEM_DATA_SCREEN (F7). When the connection is stable (the music is playing) step back to the cockpit view (F1). When the song is over... F7, back to F1,...
+
* Automerge entries from musicpacks if installed
 +
* Short music sample if player uses escapepod
 +
* Station shuffle
  
 
===DOWNLOAD===
 
===DOWNLOAD===
 
----
 
----
<b>Don't use both versions together!</b>
 
 
 
This version is the extended version:<br>
 
This version is the extended version:<br>
[[Media:Hyperradio1.14.zip | Hyperradio1.14.zip]] (517 KB) Updated 12/11/2008 - This [[OXP]] requires Oolite v1.72 or higher!
+
[http://www.box.net/shared/xjrfbnure8 Hyperradio1.16.zip] (517 KB) Updated 13/08/2009 - This [[OXP]] requires Oolite v1.72 or higher!
  
 
If you want to clean your equipment screen:<br>
 
If you want to clean your equipment screen:<br>
[[Media:Hyperradio1.14NE.zip | Hyperradio1.14NE.zip]] (517 KB) Updated 13/11/2008 - This [[OXP]] requires Oolite v1.72 or higher!
+
[[Media:Hyperradio1.14NE.zip|Hyperradio1.14NE.zip]] (517 KB) Updated 13/11/2008 - This [[OXP]] requires Oolite v1.72 or higher!
  
 
If you already have downloaded one or more of the earlier musicpacks please use the [[Media:HyperradioMusicpackUpdate.zip|script-update]] (4KB) for using the musicpacks with HyperRadio version later than v1.10. Replace the script in your musicpack with the updated script and everything should be fine. This is not necessary with the current musicpacks.
 
If you already have downloaded one or more of the earlier musicpacks please use the [[Media:HyperradioMusicpackUpdate.zip|script-update]] (4KB) for using the musicpacks with HyperRadio version later than v1.10. Replace the script in your musicpack with the updated script and everything should be fine. This is not necessary with the current musicpacks.
 
===MUSICPACKS===
 
----
 
If you are using one or more of the available [[Hyperradio_Musicpacks|musicpacks]] the Hyperradio chooses a playlist based mainly on the system.ID, but it depends also on the number of installed [[Hyperradio_Musicpacks|musicpacks]] and in some cases it gets a random chance of changing the radio station.<br>
 
 
  Example1: You have the Hyperradio + 3 musicpacks installed and you are in system 11.
 
    RESULT: Station number 3 (the last musicpack) is choosen every time.
 
 
  Example2: You have the Hyperradio + 3 musicpacks installed and you are in system 109.
 
    RESULT: Station number is choosen randomly.
 
 
  Example3: You have the Hyperradio + 3 musicpacks installed and you are in system 168.
 
    RESULT: Station number 0 (Hyperradios internal playlist) is choosen with a chance of 50%, the other 50% randomly.
 
 
It is additionally possible to create own 'stations' with your personal playlist to get even more variety.<br><br>
 
[[Hyperradio_Musicpacks]] - Here you can find the expansion packs.<br>
 
[[Hyperradio_Howto_Musicpacks]] - Here can you find a guide to create your own [[Hyperradio_Musicpacks|musicpacks]].
 
 
===TESTED FORMATS===
 
---- [[#top|top]]
 
This is a list of all formats that have been tested for the HyperRadio. Working formats are marked with YES, not working formats as no.<br>Thanks to all users who have sent in reports.
 
 
(The official word: currently, the only supported format is Ogg Vorbis. No other format works under Mac OS X. Other formats may stop working on other platforms at any time. –[[User:Ahruman|Ahruman]] 00:20, 4 October 2008 (BST))
 
 
{| width="100%" style="border: .5px solid  #cfcfbf; padding: 1em 1em 1em; color: #000000; background-color: #f7f7f7; vertical-align: top; text-align: left;"
 
|+ '''22.05KHz - 96KHz, Mono and Stereo'''
 
! Format !! Header !! WIN !! MAC !! LINUX
 
|--valign="top" bgcolor="#e7e7ff"
 
| ogg
 
| Ogg-vorbis
 
| YES
 
| YES
 
| YES
 
|-valign="top"
 
| raw
 
| headerless A-Law
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| raw
 
| headerless U-Law
 
| no
 
| no
 
| no
 
|-valign="top"
 
| raw
 
| headerless 16-Bit DWVW
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| raw
 
| headerless 24-Bit DWVW
 
| no
 
| no
 
| no
 
|-valign="top"
 
| raw
 
| Signed 16-Bit PCM
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| raw
 
| Signed 24-Bit PCM
 
| no
 
| no
 
| no
 
|-valign="top"
 
| raw
 
| Signed 32-Bit PCM
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| raw
 
| 32-Bit Float
 
| no
 
| no
 
| no
 
|-valign="top"
 
| raw
 
| 64-Bit Float
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| MS Signed 16-Bit PCM
 
| YES
 
| no
 
| YES
 
|-valign="top"
 
| wav
 
| MS 4-Bit ADPCM
 
| YES
 
| no
 
| YES
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| MS 4-Bit IMA ADPCM
 
| YES
 
| no
 
| YES
 
|-valign="top"
 
| wav
 
| MS 32-Bit Float
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| MS 64-Bit Float
 
| no
 
| no
 
| no
 
|-valign="top"
 
| wav
 
| MS U-Law
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| MS A-Law
 
| no
 
| no
 
| no
 
|-valign="top"
 
| wav
 
| MS Signed 24-Bit PCM
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| MS Signed 32-Bit PCM
 
| no
 
| no
 
| no
 
|-valign="top"
 
| wav
 
| MS 32kbs G721 ADPCM
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| MS GSM 6.10
 
| no
 
| no
 
| no
 
|-valign="top"
 
| wav
 
| NIST A-Law
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| NIST U-Law
 
| no
 
| no
 
| no
 
|-valign="top"
 
| wav
 
| NIST Signed 16-Bit PCM
 
| no
 
| no
 
| no
 
|--valign="top" bgcolor="#e7e7ff"
 
| wav
 
| NIST Signed 24-Bit PCM
 
| no
 
| no
 
| no
 
|-valign="top"
 
| wav
 
| NIST Signed 32-Bit PCM
 
| no
 
| no
 
| no
 
|-valign="top" bgcolor="#e7e7ff"
 
| flac
 
| 16-Bit L5
 
| no
 
| no
 
| no
 
|--valign="top"
 
| flac
 
| 24-Bit L5
 
| no
 
| no
 
| no
 
|}
 
 
Tested Systems: LINUX UBUNTU, MAC OS X, WIN 2000 and WIN XP.<br><br>
 
Not included formats:
 
AIFF, AU, AVR, CAF, HTK, IFF, MAT4, MAT5, MP3, OKI, PAF, PVF, SD2, SDS, SF, VOC, W64, WAVEX, XI and MS 8-Bit PCM.wav
 
  
 
===LINKS===
 
===LINKS===

Revision as of 23:18, 13 August 2009

Hyperradio.png

STORY


Trading goods between worlds is an extremely dangerous and hard job and a commander will need some relaxing moments. Listen to your radio station and enjoy Jazz, Folk, Rock or whatever you like. Use one station for all systems or expand it, so you will get different programs in different systems. You can even add your own music to the playlist. So rip your CDs, download songs, or install one or more of the available musicpacks. Everything is possible - and travelling will be much more fun - even 'milkruns' won't be boring business anymore. And with the capacity to be expanded by other users creating their own musicpacks it will always be the right investment.

Adding own songs to the main playlist of the HyperRadio is simple. Please note that only ogg-vorbis is supported by Oolite.

1. Just place your soundfiles in the OXPs Music-folder.
2. Open hyperradio.js in the Scripts-folder (you can use a simple text-editor) and add your filenames to the array.
Example:

 this.playListOriginal = new Array(
   "Rage-Back_in_time.ogg",
   "Stevie_Ray_Vaughan-Voodoo_Child.ogg"
 );

Save your additions. That's it. 3. Fire up Oolite and buy the Hyperradio license (it is not everywhere available).

  1. - Launch from the station and step to the F7 - SYSTEM_DATA_SCREEN.
  2. - When the connection is stable (the music is playing) step back to the cockpit-view (F1).
  3. - When the song is over... F7, back to F1,...

To get some more complexity it is possible to use different 'stations' with different playlists. There are a few station-musicpacks already available for you.

If you are using one or more of the available musicpacks the Hyperradio chooses a playlist based mainly on the system.ID, but it depends also on the number of installed musicpacks and in some cases it gets a random chance of changing the radio station.

Documentation about creating own stations is available at the HowTo make a own station page.

OVERVIEW


OXPConfig compatible.png

The HyperRadio is your personal tool for playing music in the game. Before it was a bit tedious to run other applications (like Winamp) for this case, because these music-players are not really connected to Oolite and the user doesn't have control about it (or has to switch to this application). The HyperRadio jumps in here to play your songs and reacts on changes in Oolite.

Additionally it is compatible and configurable via OXPConfig and Repair Bots.

Features:

  • Extended logging
  • Automerge entries from musicpacks if installed
  • Short music sample if player uses escapepod
  • Station shuffle

DOWNLOAD


This version is the extended version:
Hyperradio1.16.zip (517 KB) Updated 13/08/2009 - This OXP requires Oolite v1.72 or higher!

If you want to clean your equipment screen:
Hyperradio1.14NE.zip (517 KB) Updated 13/11/2008 - This OXP requires Oolite v1.72 or higher!

If you already have downloaded one or more of the earlier musicpacks please use the script-update (4KB) for using the musicpacks with HyperRadio version later than v1.10. Replace the script in your musicpack with the updated script and everything should be fine. This is not necessary with the current musicpacks.

LINKS


top

Hyperradio_Musicpacks
Hyperradio_Howto_Musicpacks