Difference between revisions of "Playing Videos and Music"
(Created page with "TODO: Add instructions and details on playing media in EmuVR Category:TODO") |
(Media/Streaming Guide.) |
||
Line 1: | Line 1: | ||
โ | + | Thanks to the use of the [https://docs.libretro.com/library/ffmpeg/ FFMPEG core], EmuVR supports playback of video and music files. Additionally, you can also play compatible web streams, provided you have a valid accessible URL. This guide will offer some brief instruction on setting up these types of media. | |
โ | [[Category: | + | == Video/Music == |
+ | |||
+ | Video and Music is a straightforward setup, as it functions identically to setting up games. | ||
+ | |||
+ | * Create a directory in '''EmuVR/Games''' for your movies. This can be whatever you'd like, but it's recommended you pick something along the lines of '''Videos''' or '''Music'''. | ||
+ | * Place your media files in this new directory. Compatible file formats can be seen in the libretro docs for the FFMPEG core, located [https://docs.libretro.com/library/ffmpeg/ here.] | ||
+ | * Run the Game Scanner. If you named your folder similar to the examples above, it should detect them when you attempt autofill. If not, add them manually. | ||
+ | * Ensure the media type is set to '''Video''' or '''Music''' depending on the media. (Note: At this moment both VHS/DVD and CD/Casette are functionally identical. These options are just placeholders for when more models are added. | ||
+ | * Launch EmuVR. | ||
+ | |||
+ | As long as you've used compatible media and setup the Game Scanner properly, you should now have the option to spawn a new system and cartridges for your Videos and Music. | ||
+ | |||
+ | === Important Notes === | ||
+ | |||
+ | * As mentioned above, the '''VHS/DVD''' and '''Casette/CD''' are currently functionally identical, and will spawn a generic console. The options are placeholders for when more models are created in the future. | ||
+ | * As is the case with games, each media file will create its own cartridge and label. This means that each file takes up a small amount of VRAM, and as such it is advised that you ''not'' dump too many files into the game at once. | ||
+ | * If you would like to play more than one file per cartridge, you can do so by manually merging your files(a topic not covered here, as it is somewhat advanced), or see the below section on ''Streaming'' for an alternative. | ||
+ | |||
+ | |||
+ | == <div id="streaming">Streaming</div> == | ||
+ | |||
+ | Sometimes, the media you want to access is not presented in a nice, compatible file. Be it a stream online of music/video, or perhaps you want to watch more than one video without having to swap cartridges in game. This is where EmuVR's streaming support comes in. | ||
+ | |||
+ | === Streaming from the Web === | ||
+ | |||
+ | The FFMPEG Core, by default, handles a wide variety of media including common stream formats. Getting those URLs into EmuVR is fairly straightforward, but does need a bit of manual work. | ||
+ | |||
+ | * Create a new file in your '''Games/Video''' directory. You can name it whatever you would like, but it '''must''' end with the extension '''.str'''. | ||
+ | * Open this new file with a text editor. Notepad will do. | ||
+ | * Paste the link to the stream you'd like to play. Note that this needs to be a '''direct link''', not just the webpage the stream is on. A direct link will end with a file format, and will usually prompt you to download a file if you put it in your browser. (As an example, the link might look something like '''http://mycoolsite.com/stream/supercoolstream.m3u8'''. | ||
+ | * Save the file. | ||
+ | * Run Game Scanner. You should now have a cartridge in game named after the '''.str''' file you created. | ||
+ | |||
+ | ''IMPORTANT NOTE'' | ||
+ | If the console immediately turns off without playing, it typically suggests that either the link is not accessible or that it is not compatible with ffmpeg. Verify that you are using a direct link to the stream. | ||
+ | |||
+ | === Streaming from your PC === | ||
+ | |||
+ | Sometimes, the media you want to stream isn't on the web, or you aren't able to get a direct link. Perhaps you'd like to use your own media and play a series of videos or music without needing to swap cartridges each episode. Maybe you have a bunch of shows and old commercials in a playlist that you'd like to watch to emulate a TV channel. While this functionality isn't supported by default in EmuVR, a workaround has been created by a user of the community using the popular media program [https://www.videolan.org/vlc/index.html VLC]. | ||
+ | |||
+ | * If you don't already have it, download and install VLC. | ||
+ | * Create a new file in your '''Games/Video''' directory. You can name it whatever you would like, but it '''must''' end with the extension '''.str'''. | ||
+ | * Open this new file with a text editor. Notepad will do. | ||
+ | * This is where things get tricky. In this file, you need to enter the following: '''http://127.0.0.1:8080/MYSTREAM.ts'''. The '''MYSTREAM''' can be whatever word you would like, but the rest of the link '''must''' match the example given. For these instructions, we will be using the URL '''http://127.0.0.1:8080/teststream.ts'''. | ||
+ | * Open VLC. | ||
+ | * If using default hotkeys in VLC, press ''Control + S''. Alternatively, you can open the proper menu via ''Media -> Stream''. | ||
+ | * In the window that appears, add your media. These can be any format VLC supports. | ||
+ | * Once you've added some files, click ''Stream''. | ||
+ | * Click ''Next.'' In the Destination Setup Window, click the dropdown that currently says '''File'''. Change this to '''HTTP'''. Click '''Add'''. | ||
+ | * Leave the port as 8080. Only change this if you know what you're doing or why you're doing it. | ||
+ | * Set the '''Path''' to '''/MYSTREAM.ts''', or whatever you chose in place of '''MYSTREAM'''. In this case, we're going to use '''/teststream.ts'''. | ||
+ | * Click Next. | ||
+ | * Ensure '''Activate Transcoding''' is ticked. In the profile box, choose '''Video - H.264 + MP3 (TS)'''. | ||
+ | * Choose Next. Then, choose Stream. | ||
+ | |||
+ | You're done. You should now see the files you chose appear in you VLC playlist, and the timestamp will be moving. You may not see the video actually playing in VLC- this is normal, as long as the timestamp is moving your files are streaming. Open EmuVR and play your new stream cartridge. It might take a few seconds to load, but you'll eventually see your video file playing on the TV. | ||
+ | |||
+ | ''' IMPORTANT NOTE ''' | ||
+ | * This method of streaming is likely not the most efficient, and exists only as a workaround to play a large number of media files on one cartridge without needing to swap them out. | ||
+ | * VLC '''must''' remain running, and the files must be playing in order for the stream to work. If you attempt to play the stream cartridge without VLC running/playing, it will simply turn off without loading anything. | ||
+ | * If you decide you want to add more files to this playlist, you will need to do so via the Stream menu. Otherwise, VLC will just play the file as a regular file and your console in-game will shut off. | ||
+ | * You ''can'' save the playlist of streaming files with VLC to open it again later without needing to go through all the setup steps again. | ||
+ | |||
+ | [[Category:Guide]] |
Revision as of 16:39, 6 November 2018
Thanks to the use of the FFMPEG core, EmuVR supports playback of video and music files. Additionally, you can also play compatible web streams, provided you have a valid accessible URL. This guide will offer some brief instruction on setting up these types of media.
Contents
Video/Music
Video and Music is a straightforward setup, as it functions identically to setting up games.
- Create a directory in EmuVR/Games for your movies. This can be whatever you'd like, but it's recommended you pick something along the lines of Videos or Music.
- Place your media files in this new directory. Compatible file formats can be seen in the libretro docs for the FFMPEG core, located here.
- Run the Game Scanner. If you named your folder similar to the examples above, it should detect them when you attempt autofill. If not, add them manually.
- Ensure the media type is set to Video or Music depending on the media. (Note: At this moment both VHS/DVD and CD/Casette are functionally identical. These options are just placeholders for when more models are added.
- Launch EmuVR.
As long as you've used compatible media and setup the Game Scanner properly, you should now have the option to spawn a new system and cartridges for your Videos and Music.
Important Notes
- As mentioned above, the VHS/DVD and Casette/CD are currently functionally identical, and will spawn a generic console. The options are placeholders for when more models are created in the future.
- As is the case with games, each media file will create its own cartridge and label. This means that each file takes up a small amount of VRAM, and as such it is advised that you not dump too many files into the game at once.
- If you would like to play more than one file per cartridge, you can do so by manually merging your files(a topic not covered here, as it is somewhat advanced), or see the below section on Streaming for an alternative.
Streaming
Sometimes, the media you want to access is not presented in a nice, compatible file. Be it a stream online of music/video, or perhaps you want to watch more than one video without having to swap cartridges in game. This is where EmuVR's streaming support comes in.
Streaming from the Web
The FFMPEG Core, by default, handles a wide variety of media including common stream formats. Getting those URLs into EmuVR is fairly straightforward, but does need a bit of manual work.
- Create a new file in your Games/Video directory. You can name it whatever you would like, but it must end with the extension .str.
- Open this new file with a text editor. Notepad will do.
- Paste the link to the stream you'd like to play. Note that this needs to be a direct link, not just the webpage the stream is on. A direct link will end with a file format, and will usually prompt you to download a file if you put it in your browser. (As an example, the link might look something like http://mycoolsite.com/stream/supercoolstream.m3u8.
- Save the file.
- Run Game Scanner. You should now have a cartridge in game named after the .str file you created.
IMPORTANT NOTE If the console immediately turns off without playing, it typically suggests that either the link is not accessible or that it is not compatible with ffmpeg. Verify that you are using a direct link to the stream.
Streaming from your PC
Sometimes, the media you want to stream isn't on the web, or you aren't able to get a direct link. Perhaps you'd like to use your own media and play a series of videos or music without needing to swap cartridges each episode. Maybe you have a bunch of shows and old commercials in a playlist that you'd like to watch to emulate a TV channel. While this functionality isn't supported by default in EmuVR, a workaround has been created by a user of the community using the popular media program VLC.
- If you don't already have it, download and install VLC.
- Create a new file in your Games/Video directory. You can name it whatever you would like, but it must end with the extension .str.
- Open this new file with a text editor. Notepad will do.
- This is where things get tricky. In this file, you need to enter the following: http://127.0.0.1:8080/MYSTREAM.ts. The MYSTREAM can be whatever word you would like, but the rest of the link must match the example given. For these instructions, we will be using the URL http://127.0.0.1:8080/teststream.ts.
- Open VLC.
- If using default hotkeys in VLC, press Control + S. Alternatively, you can open the proper menu via Media -> Stream.
- In the window that appears, add your media. These can be any format VLC supports.
- Once you've added some files, click Stream.
- Click Next. In the Destination Setup Window, click the dropdown that currently says File. Change this to HTTP. Click Add.
- Leave the port as 8080. Only change this if you know what you're doing or why you're doing it.
- Set the Path to /MYSTREAM.ts, or whatever you chose in place of MYSTREAM. In this case, we're going to use /teststream.ts.
- Click Next.
- Ensure Activate Transcoding is ticked. In the profile box, choose Video - H.264 + MP3 (TS).
- Choose Next. Then, choose Stream.
You're done. You should now see the files you chose appear in you VLC playlist, and the timestamp will be moving. You may not see the video actually playing in VLC- this is normal, as long as the timestamp is moving your files are streaming. Open EmuVR and play your new stream cartridge. It might take a few seconds to load, but you'll eventually see your video file playing on the TV.
IMPORTANT NOTE
- This method of streaming is likely not the most efficient, and exists only as a workaround to play a large number of media files on one cartridge without needing to swap them out.
- VLC must remain running, and the files must be playing in order for the stream to work. If you attempt to play the stream cartridge without VLC running/playing, it will simply turn off without loading anything.
- If you decide you want to add more files to this playlist, you will need to do so via the Stream menu. Otherwise, VLC will just play the file as a regular file and your console in-game will shut off.
- You can save the playlist of streaming files with VLC to open it again later without needing to go through all the setup steps again.