Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
splash_boot [2020/10/08 18:07] lbrpdxsplash_boot [2022/05/22 04:42] (current) lbrpdx
Line 1: Line 1:
-~~NOTOC~~ +====== Splash Image/Video Customization ======
-===== Splash Boot =====+
  
-Since Batocera 5.27 the progress of adding images and videos is much easier to do. Just copy the appropriate files to your dedicated SHARE directory ''splash'' (on your SMB network) and on reboot you can see your newest selections. +Batocera displays a total of three splash images during a regular boot sequence:
  
-**WARNING:** ultimately, those splash videos will be copied into your ''/boot/'' partition, which has limited space. Depending on your architecture, the sizes of your potential overlays and many other parameters, you might be limited to 100s of MB left on the ''/boot/'' partition, less than 1 GB in most cases. Make sure you don't put too many videos in your ''splash'' directory or the process will not work.+  - The boot splash 
 +  - The custom user splash 
 +  - The EmulationStation loading splash
  
-Batocera.linux supports 2 kinds of splash boot.+The custom user splash can be either of the following:
  
-  * MP4 videos (for SBCbut not for x86_64 or x86 platforms at the momentsorry guys)  +  * MP4 videos (for **RPi****RPi2****RPi3**, **Odroid XU4**, **Odroid N2**/**N2+**, **Khadas VIM3** and **RockPro64**... and **Pi4**, **s905gen3** and **PC** on Batocera **v31** and higher)  
-  * A fixed PNG image for all platforms+  * A static PNG image (for all platforms)
  
-Video (if available) gets higher loading priority than pictures.+Video (if available for the platform) gets higher loading priority than images if both are present in the custom user splash folder. Here are some splash screen/video resources: 
 +  * [[https://batocera.org/videos/boot/|SnakerVill's splashes and others on our server]] 
 +  * [[https://www.batoceranation.com/downloads/|BatoceraNation's download page]] 
 +  * [[https://www.youtube.com/channel/UCJdquk3Rr_nZVLEc9JryhAA/videos|Splash Screen Studio's Youtube channel]] 
 +  * [[https://github.com/Hew-ux/batocera-assets/tree/main/splash-screens|The Batocera-Assets repository's splash screen folder]] and [[https://github.com/Hew-ux/batocera-assets/tree/main/archive/splash-screens|its archives]]. 
 +  * [[https://mega.nz/folder/Q6B0iLjQ#oFP0d6huWdHGQLaAVvsgmQ|Hel Mic's splash video Mega folder]]. Here's a [[https://www.youtube.com/watch?v=S1-deoLf_cA&list=PLHL2dKEpMn1GmfvrtFioLd5MQgXD4VoCi&index=24|YouTube playlist]] that includes them.
  
-Splash boot screens can be customized by editing ''batocera.conf''.+Since Batocera **5.27** the process of adding splash images or videos is much easier to do. Just copy the appropriate files to ''/userdata/splash/''On the next reboot you will see your new splashes!
  
-==== Disable sound on Video Splash ==== +<WRAP center round important 60%> 
-By default, the sound is enabled. +In Batocera **v31** and lower, those splash videos will be copied into your ''/boot'' partition, which has limited space. Depending on your architecture, the sizes of your potential overlays and many other parameters, you might be limited to 100 MB or so space that you can actually use. Make sure you don't put too many videos in your ''splash'' directory or you may not be able to update in the future! Again, this only applies to **v31** and lower. 
-To disable it, edit the file ''/userdata/system/batocera.conf'' (or from the SHARE network folder) to get a line exactly like this one (without #) :+</WRAP> 
 + 
 +You can have multiple MP4 videos or PNG image files in ''splash'' and the system will select one at random. 
 + 
 +On the **Odroid Go Advance** and other devices, according to the bootloader at least, the screen is physically rotated. So either you need to rotate your splash screen 90 degrees counter-clockwise or utilize the ''display.rotate'' option specified below to rotate the screen system-wide. 
 + 
 +===== Custom user splash settings ===== 
 + 
 +==== Video splash settings (sound, rotation, resize) ==== 
 + 
 +To disable splash video altogether, you can also disable it in the same file ''/boot/batocera-boot.conf'' with: 
 +  splash.screen.enabled=0 
 +   
 +<WRAP center round tip> 
 +Don't forget that for any modification on ''/boot/'', you should read [[:edit_boot_partition|this instruction page on how to do so]] first. 
 +</WRAP> 
 + 
 +By default, the sound is enabled. To disable it, edit the file ''batocera.conf'' (from the SHARE partition of your SDCard/USB, not the same as above) to get a line exactly like this one (without #):
   splash.screen.sound=0   splash.screen.sound=0
      
-==== Change the Video Splash duration ==== +If you need to rotate the splash video, you can tune this parameter in the same file ''batocera.conf'' (which also rotates EmulationStation): 
-If you want to run your video splash screen for the whole length of it, edit ''/userdata/system/batocera.conf'' (or from the SHARE network folder) and, if you want to make it 42 seconds, add a line like:+  display.rotate=1 
 +  
 +The value for rotation can be ''0'', ''1'', ''2'' or ''3'' representing 0, 90, 180 or 270 degrees of rotation respectively. 
 +  
 +By default, the Batocera version is overlaid on top of the video. To disable the overlay, edit the file ''batocera.conf'' (from the SHARE partition of your SDCard/USB) to get a line exactly like this one (without #): 
 +  splash.screen.subtitle=0 
 + 
 +If you want to resize the splash video to a new resolution, add the following line to ''batocera.conf'' (Batocera **v32** and above): 
 +  splash.screen.resize=1280x720 
 + 
 +With of course the resolution you want. 
 + 
 +<WRAP center round tip> 
 +This can help with laggy splash videos on 4k TVs! Though, depending on the TV, this might not help at all. 
 +</WRAP> 
 + 
 +==== Change the video splash duration ==== 
 + 
 +If you want to run your video splash screen for the whole length of it, edit ''/userdata/system/batocera.conf'' (or from the SHARE network folder, yes, this is not the same file as above!) and, if you want to make it 42 seconds, add a line like:
  
   splash.screen.length=42    splash.screen.length=42 
Line 27: Line 68:
 Any value can be set between 0 and 90 seconds. Any value can be set between 0 and 90 seconds.
  
-You can also use ''k'' and ''i'' as a prefix before the timer. +===== Changing EmulationStation's default loading splash =====
-  * ''i42'' : the video player terminates itself, to a maximum length of 42 seconds +
-  * ''k42'' : the video player is killed after 42 seconds, but it will stay on for the whole 42 seconds +
-==== Notes only for older Batocera versions <5.26 ====+
  
-=== Customize splash video (only on RPi, RPi2, RPi3, Odroid XU4 and RockPro64) === +If instead you'd like to edit the splash image that shows while EmulationStation is parsing the games list (the loading bar), you can instead edit ''/usr/share/emulationstation/resources/logo.png'' and then run ''batocera-save-overlay'' [[:access_the_batocera_via_ssh|via SSH]]You'll have to do this every updateKeep in mind this can be overridden by custom themesin this case you'll need to find the equivalent file within that theme's folder.
-Put a file in ''/boot/splash.mp4'' on the USB key/SD card to replace the default video. Starting with Batocera 5.25, you can have multiple ''*.mp4'' files in ''/boot/'' and the system will select one at randomAlso, with Batocera 5.25+, you can also add splash images too.+
  
-=== Image splash boot ==+===== Changing the boot splash =====
-You can change the splash boot image by putting your own file as ''/boot/splash.png''. On Batocera 5.25+, you can have multiple ''*.png'' files in ''/boot/'' and the system will select one at random.+
  
-On the **Odroid Go Advance**, by design, the screen is physically rotatedSo you need to rotate your splash screen 90 degrees counter-clockwise to make it appear with the right orientation.+You'll notice that Batocera always displays the default Batocera splash image before your own custom one. This is by design, as Batocera cannot access the userdata partition until later in the boot sequenceIf you'd like to change this image, however, you still can. Simply replace the file at ''/usr/share/batocera/splash/boot-logo.png'' with another PNG file and then run ''batocera-save-overlay'' [[:access_the_batocera_via_ssh|via SSH]]. You'll have to do this every update. Note that you can **only** replace the PNG image with another PNG image, other types of media will simply not be read.
  
-Please note that throughout this page, the path ''/boot/'' refers to the Linux path on your Batocera box. However, if you mount your Batocera USB key/SD card on a Windows machine, that path will be the root of your mount point shown as BATOCERA like ''F:\'' or whatever is your mount letter for your Batocera USB key/SD card ).+<WRAP center round info> 
 +You may notice there is a separate ''splash.mp4'' file, this is the "default" splash video. If intending on using your own splash video, there is no need to replace this here as any video file found in ''/userdata/splash/'' will automatically replace this at boot. 
 +</WRAP> 
 + 
 +In case you'd like to completely "disable" it, here is a black PNG image file you can use in its place (click for the full 1920x1080 image): 
 + 
 +{{:black.png?direct&360|Eternal darkness.}} 
 + 
 +===== Demonstration ===== 
 + 
 +{{:20210927_211414.webm?655x368|I have zero regrets.}} 
 + 
 +===== Notes only for older Batocera versions <= 5.26 ===== 
 + 
 +--> Click to expand# 
 + 
 +**Image splash boot** 
 + 
 +You can change the splash boot image by putting your own file as ''/boot/splash.png''. On Batocera 5.25+, you can have multiple ''*.png'' files in ''/boot'' and the system will select one at random. 
 + 
 +Please note that throughout this page, the path ''/boot'' refers to the Linux path on your Batocera box. However, if you mount your Batocera USB key/SD card on a Windows machine, that path will be the root of your mount point shown as BATOCERA like ''F:\'' or whatever is your mount letter for your Batocera USB key/SD card. 
 + 
 +**Disable sound on Video Splash for older Batocera versions**
  
-=== Disable sound on Video Splash === 
 By default, the sound is enabled. By default, the sound is enabled.
-To disable it, edit the file ''/boot/batocera-boot.conf'' on the usb key/sdcard to get a line exactly like this one (without #) : +To disable it, edit the file ''/boot/batocera-boot.conf'' on the USB drive/SD card to get a line exactly like this one (without #): 
-  splashsound = off+ 
 +<code> 
 +splashsound = off 
 +</code>
  
 +<--
  
  • splash_boot.1602173239.txt.gz
  • Last modified: 4 years ago
  • by lbrpdx