PPlay Switch: Difference between revisions

pPlay
pPlay
General
Author	Cpasjuste
Type	Media Players
Version	3.5
License	Mixed
Last Updated	2021/03/12
Links
	Download
	Website
	Source
	Support Author

Latest revision as of 05:46, 18 July 2024

pPlay is a video player designed specifically for the Nintendo Switch. It supports a wide range of popular video formats, subtitles, as well as http and ftp streaming.

pPlay uses the MPV interface to handle ffmpeg interoperability, which provide a fast, stable and powerful experience.

The homebrew was participated in the GBAtemp Switch Homebrew Bounty 2018 (Switch application, 2nd place).

Installation

Copy the "pplay" folder to the switch folder on the SD card ("/switch/pplay").

It is advised you use an NSP HBL (HomeBrew Loader) to unleash all Switch memory to launch pPlay, else you'll have some memory memory problem/crash.

Alternatively if you are using Atmosphere, you can press R when launching a game, this will load the HBL (HomeBrew Loader) with all memory unlocked.

User guide

Stream from an HTTP server

pPlay can stream media from an http server with directory listing enabled, or an ftp server.

To do so, you must edit the configuration file (pplay.cfg) to add your server address:

NETWORK = "http://samples.ffmpeg.org/";
NETWORK = "ftp://user:password@ip:port/";

Configuration

As pPlay use MPV, you can put a file named "mpv.conf" in the "mpv" folder to play with.

See the Configuration Files and Options sections in the MPV manual for more information.

Notes

pPlay should be able to play most media. While 720p and 1080p medias should be fine, you can unlock all the Switch CPU speed for heavy medias in the main options menu (Left button).

Controls

Left/Right - Switch menu's and windows

When playing a media:

Down or A - Bring the UI

R - Fast forward

L - Stop

Left - Access video, audio and subtitles selection

Screenshots

Media

pplay (cpasjuste)

pPlay 1.2 Video Player for Nintendo Switch (Carlos Portilha)

Changelog

v3.5 2021/03/12

Add back ftp support.
Bug fixes and stability improvements.

v3.4 2021/01/26

Fix usb.

v3.3 2021/01/21

Add usb support (thanks @ShroomKing).
Fix subtitles.
Fix keys auto repeat.
Fix missing dots (..) on empty dirs.
Update mpv (0.33.0).
Update ffmpeg (4.3.1).

v3.1 2019/11/20

Fix incorrect screen resolution.
Improve scraper results with levenshtein algorithm.
Few fixes and improvements.

v3.0 2019/11/13

Fix for 9.0+ firmware.
Add tmdb scraper.
Lot, lot of untracked changes (ui, browser....).

v2.1 2019/03/29

Player: hide loading message and report error... on file loading error.
Player: fix http browsing of folders with the ' special characters.
Player: fix http loading of files with special characters.
Player: speedup http browsing.

v2.0 2019/03/28

Use mpv interface as ffmpeg wrapper (provide a fast, stable and powerful experience).
Add external font support.
Disable automatic media info extraction thread, media info is extracted when a media is loaded.
Lot of fixes and improvements.
Update readme.

v.1.5 2019/01/18

Enable rmvb extension support.
Increase subtitle atlas size, should/may fix truncated subtitles.
Fix pause/resume when using home button.
Fix audio synchronization when using home button.
Reset osd play button when seeking.
Allow audio frequency < 48 khz without software conversion.

v1.4 2019/01/12

Implement threading (major speed improvement).
Fix date format in status bar.
Fix status bar not hidden on timeout hide.
Set lower buffering option by default (thanks threading).

v1.3 2019/01/09

Improve audio decoding (fix some audio desynchronization, most 720p media seems to works fine even with medium buffering, this also fix some audio seeking problem in some media).
Add status bar (time and battery).
Add crappy "pPlay" title image.
Fix some random crashes when scanning media folder.

v1.2 2018/12/21

Player: disable screen dimming and auto sleep when playing.
Player: fix pcm* audio format (unable to initialize audio resampler error).
Player: fix "unsupported sutbtitle format" error (subtitle will be disabled).
pplay: add ftp support (ftp://user:password@ip:port/), WIP (very slow loading time..).
pplay: fix media information caching of long path/filename.
pplay: force loading of media information on load if not cached.

v1.1 2018/12/20

Player: fix "VeryHigh" buffer option not working..

v1.0 2018/12/19

First Release.

External links

GitHub - https://github.com/Cpasjuste/pplay
GBAtemp - https://gbatemp.net/threads/pplay-switch-video-player.526187/
ForTheUsers - https://apps.fortheusers.org/switch/pplay

@@ Line 1: / Line 1: @@
 {{Infobox Switch Homebrews
 |title=pPlay
-|image=pplayswitch.png
+|image=pplaynx.png
-|description=A switch video player.
+|description=A Switch video player.
 |author=Cpasjuste
 |lastupdated=2021/03/12
-|type=Media players
+|type=Media Players
 |version=3.5
 |license=Mixed
-|download=https://dlhb.gamebrew.org/switchhomebrews/pplayswitch.7z
+|download=https://dlhb.gamebrew.org/switchhomebrews/pplaynx.7z
 |website=https://gbatemp.net/threads/pplay-switch-video-player.526187/
 |source=https://github.com/Cpasjuste/pplay
-|donation=
+|donation=https://ko-fi.com/cpasjuste
 }}
-{{#seo:
+pPlay is a video player designed specifically for the Nintendo Switch. It supports a wide range of popular video formats, subtitles, as well as http and ftp streaming.
-|title=Switch Homebrew Apps (Media players) - GameBrew
-|title_mode=append
+pPlay uses the [https://mpv.io/ MPV] interface to handle ffmpeg interoperability, which provide a fast, stable and powerful experience.
-|image=pplayswitch.png
-|image_alt=pPlay
-}}
-pPlay is a video player designed specifically for the Nintendo Switch console. It is capable of supporting a wide range of popular video formats, subtitles, as well as http and ftp streaming.
-Moreover, pPlay utilizes the MPV interface to ensure seamless ffmpeg interoperability, providing users with a fast, stable, and robust experience.
+The homebrew was participated in the GBAtemp Switch Homebrew Bounty 2018 (Switch application, 2nd place).
 ==Installation==
-*Copy "pplay" folder to switch sdcard ("/switch/pplay").
+Copy the "pplay" folder to the switch folder on the SD card ("/switch/pplay").
+It is advised you use an [[Homebrew_Menu_Loader_Switch|NSP HBL (HomeBrew Loader)]] to unleash all Switch memory to launch pPlay, else you'll have some memory memory problem/crash.
+Alternatively if you are using Atmosphere, you can press R when launching a game, this will load the HBL (HomeBrew Loader) with all memory unlocked.
-==Usage==
+==User guide==
-* Use left/right to switch menu's and windows... select a media and... have fun.
+===Stream from an HTTP server===
-* When playing a media, you can press the "DOWN" or "A" button to bring the UI, the "R" shoulder for fast forward ("L" button to stop), and "LEFT" to access video, audio and subtitles selection.
+pPlay can stream media from an http server with directory listing enabled, or an ftp server.
-==Media==
+To do so, you must edit the configuration file (pplay.cfg) to add your server address:
-'''pPlay 1.2 Video Player for Nintendo Switch - ([https://www.youtube.com/watch?v=6vvk_26aTUQ Carlos Portilha])'''<br>
+* <nowiki>NETWORK = &quot;http://samples.ffmpeg.org/&quot;;</nowiki>
-<youtube>6vvk_26aTUQ</youtube>
+* <nowiki>NETWORK = &quot;ftp://user:password@ip:port/&quot;;</nowiki>
+===Configuration===
+As pPlay use [https://mpv.io/ MPV], you can put a file named &quot;mpv.conf&quot; in the &quot;mpv&quot; folder to play with.
+See the [https://mpv.io/manual/master/#configuration-files Configuration Files] and [https://mpv.io/manual/master/#options Options] sections in the [https://mpv.io/manual/master/# MPV] manual for more information.
+===Notes===
+pPlay should be able to play most media. While 720p and 1080p medias should be fine, you can unlock all the Switch CPU speed for heavy medias in the main options menu (Left button).
+==Controls==
+Left/Right - Switch menu's and windows
+'''When playing a media:'''
+Down or A - Bring the UI
+R - Fast forward
+L - Stop
+Left - Access video, audio and subtitles selection
 ==Screenshots==
-https://dlhb.gamebrew.org/switchhomebrews/pplayswitch-01.png
+https://dlhb.gamebrew.org/switchhomebrews/pplaynx.png
-https://dlhb.gamebrew.org/switchhomebrews/pplayswitch-02.png
+https://dlhb.gamebrew.org/switchhomebrews/pplaynx2.png
+https://dlhb.gamebrew.org/switchhomebrews/pplaynx3.png
+https://dlhb.gamebrew.org/switchhomebrews/pplaynx4.png
+https://dlhb.gamebrew.org/switchhomebrews/pplaynx5.png
+https://dlhb.gamebrew.org/switchhomebrews/pplaynx6.png
-== Notes ==
+==Media==
-* pPlay can stream media from an http server with directory listing enabled, or an ftp server. To do so, you must edit the configuration file (pplay.cfg) to add your server address:
+'''pplay''' ([https://www.youtube.com/watch?v=zbbuUdMJSWE cpasjuste]) <br>
-** NETWORK = &quot;http://samples.ffmpeg.org/&quot;;
+<youtube>zbbuUdMJSWE</youtube>
-** NETWORK = &quot;ftp://user:password@ip:port/&quot;;
-* As pPlay use [https://mpv.io/ MPV], you can put a file named &quot;mpv.conf&quot; in the &quot;mpv&quot; folder to play with. See the [https://mpv.io/manual/master/#configuration-files CONFIGURATION FILES] and [https://mpv.io/manual/master/#options OPTIONS] sections in the [https://mpv.io/manual/master/# MPV] manual for more informations.
+'''pPlay 1.2 Video Player for Nintendo Switch ([https://www.youtube.com/watch?v=6vvk_26aTUQ Carlos Portilha])'''<br>
-* pPlay should be able to play most media. While 720p and 1080p medias should be fine, you can unlock all the switch cpu speed for heavy medias in the main options menu (LEFT button)
+<youtube>6vvk_26aTUQ</youtube>
 ==Changelog==
-'''v.3.5'''
+'''v3.5 2021/03/12'''
-* add back ftp support
+* Add back ftp support.
-* bug fixes and stability improvements..
+* Bug fixes and stability improvements.
-'''v.3.4'''
+'''v3.4 2021/01/26'''
-*fix usb
+* Fix usb.
-'''v.3.3'''
+'''v3.3 2021/01/21'''
-* add usb support (thanks @ShroomKing)
+* Add usb support (thanks @ShroomKing).
-* fix subtitles
+* Fix subtitles.
-* fix keys auto repeat
+* Fix keys auto repeat.
-* fix missing dots (..) on empty dirs
+* Fix missing dots (..) on empty dirs.
-* update mpv (0.33.0)
+* Update mpv (0.33.0).
-* update ffmpeg (4.3.1)
+* Update ffmpeg (4.3.1).
-'''v.3.1'''
+'''v3.1 2019/11/20'''
-* fix incorrect screen resolution
+* Fix incorrect screen resolution.
-* improve scraper results with levenshtein algorithm
+* Improve scraper results with levenshtein algorithm.
-* few fixes and improvements
+* Few fixes and improvements.
-'''v.3.0'''
+'''v3.0 2019/11/13'''
-* fix for 9.0+ firmware
+* Fix for 9.0+ firmware.
-* add tmdb scraper
+* Add tmdb scraper.
-* lot, lot of untracked changes (ui, browser....)...
+* Lot, lot of untracked changes (ui, browser....).
-'''v.2.1'''
+'''v2.1 2019/03/29'''
-* player: hide loading message and report error... on file loading error
+* Player: hide loading message and report error... on file loading error.
-* player: fix http browsing of folders with the ' special characters
+* Player: fix http browsing of folders with the ' special characters.
-* player: fix http loading of files with special characters
+* Player: fix http loading of files with special characters.
-* player: speedup http browsing
+* Player: speedup http browsing.
-'''v.2.0'''
+'''v2.0 2019/03/28'''
-* use mpv interface as ffmpeg wrapper (provide a fast, stable and powerful experience)
+* Use mpv interface as ffmpeg wrapper (provide a fast, stable and powerful experience).
-* add external font support
+* Add external font support.
-* disable automatic media info extraction thread, media info is extracted when a media is loaded
+* Disable automatic media info extraction thread, media info is extracted when a media is loaded.
-* lot of fixes and improvements
+* Lot of fixes and improvements.
-* update readme
+* Update readme.
-'''v.1.5'''
+'''v.1.5 2019/01/18'''
-* enable rmvb extension support
+* Enable rmvb extension support.
-* increase subtitle atlas size, should/may fix truncated subtitles
+* Increase subtitle atlas size, should/may fix truncated subtitles.
-* fix pause/resume when using home button
+* Fix pause/resume when using home button.
-* fix audio synchronization when using home button
+* Fix audio synchronization when using home button.
-* reset osd play button when seeking
+* Reset osd play button when seeking.
-* allow audio frequency < 48 khz without software conversion
+* Allow audio frequency < 48 khz without software conversion.
-'''v.1.4'''
+'''v1.4 2019/01/12'''
-* implement threading (major speed improvement)!
+* Implement threading (major speed improvement).
-* fix date format in status bar
+* Fix date format in status bar.
-* fix status bar not hidden on timeout hide
+* Fix status bar not hidden on timeout hide.
-* set lower buffering option by default (thanks threading)
+* Set lower buffering option by default (thanks threading).
-'''v.1.3'''
+'''v1.3 2019/01/09'''
-* improve audio decoding (fix some audio desynchronization, most 720p media seems to works fine even with medium buffering, this also fix some audio seeking problem in some media)
+* Improve audio decoding (fix some audio desynchronization, most 720p media seems to works fine even with medium buffering, this also fix some audio seeking problem in some media).
-* add status bar (time and battery)
+* Add status bar (time and battery).
-* add crappy "pPlay" title image
+* Add crappy "pPlay" title image.
-* fix some random crashes when scanning media folder
+* Fix some random crashes when scanning media folder.
-'''v.1.2'''
+'''v1.2 2018/12/21'''
-* player: disable screen dimming and auto sleep when playing
+* Player: disable screen dimming and auto sleep when playing.
-* player: fix pcm* audio format (unable to initialize audio resampler error)
+* Player: fix pcm* audio format (unable to initialize audio resampler error).
-* player: fix "unsupported sutbtitle format" error (subtitle will be disabled)
+* Player: fix "unsupported sutbtitle format" error (subtitle will be disabled).
-* pplay: add ftp support (ftp://user:password@ip:port/), WIP (very slow loading time..)
+* pplay: add ftp support (ftp://user:password@ip:port/), WIP (very slow loading time..).
-* pplay: fix media information caching of long path/filename
+* pplay: fix media information caching of long path/filename.
-* pplay: force loading of media information on load if not cached
+* pplay: force loading of media information on load if not cached.
-'''v.1.1'''
+'''v1.1 2018/12/20'''
-*player: fix "VeryHigh" buffer option not working.
+* Player: fix "VeryHigh" buffer option not working..
-'''v.1.0'''
+'''v1.0 2018/12/19'''
 * First Release.
 == External links ==
-* Official Website - https://gbatemp.net/threads/pplay-switch-video-player.526187/
+* GitHub - https://github.com/Cpasjuste/pplay
-* Github - https://github.com/Cpasjuste/pplay
+* GBAtemp - https://gbatemp.net/threads/pplay-switch-video-player.526187/
+* ForTheUsers - https://apps.fortheusers.org/switch/pplay
+[[Category:GBAtemp Homebrew Bounty 2018]]