Edit Infobox PSP Homebrews: BetterBright PSP

Free text:

<!--BetterBrightPSP.7z--> BetterBright, a PSP brightness control plugin for ARK-4 / FasterARK custom firmware. Loosely based on the older [[Bright3_prx_PSP|bright3]] by [https://github.com/hiroi01 @hiroi01] (itself a mod of bright by plum) - which is where the original idea came from. == Features == * '''Remembers brightness state''' when launching games / rebooting / waking / exiting to XMB. * '''Fully customisable brightness levels''', with 11 sensible per-model defaults if you don't set your own. * '''Configurable key combo''' to set brightness level up or down without cycling (the '''Display''' button still cycles as normal). * '''Show the current brightness level''' on screen (OSD). ** Shows in XMB, (most) games, PS1 and homebrew. ** Customise the OSD position, size (1x-4x), background and text colours. ** The "Brightness Level" label shows in your system language. * Option to '''choose a custom "dim" level'''. * Option to '''disable display dimming / backlight auto-off''' ("Power Save"). * Option to '''disable auto-sleep''' ("Power Save") (use with caution). * Developed and tested on '''6.61''' / '''FasterARK''' and '''ARK-4''', '''should work fine with 6.60'''. * Older firmwares untested. Just upgrade to 6.60/6.61, it's 2026, you'll be fine. == Installation == Put <code>BetterBright.prx</code> and <code>BetterBright.ini</code> together in your plugins folder and enable BetterBright in the ARK Custom Launcher. https://github.com/PSP-Archive/ARK-4/wiki/Plugins (The included <code>vsh.txt</code> / <code>game.txt</code> / <code>pops.txt</code> in the <code>legacy</code> folder are only for loaders that still use seplugins-style text files. Do yourself a favour and just use ARK-4 or FasterARK, it's way better.) == User guide == Press the PSP's "Display (brightness)" button as normal to cycle through the brightness values. Hold L or R Trigger then tap the "Display" button: R = brighter, L = dimmer. You can also use L + R then Up or Down (D-Pad) when you set <code>combo_mode=2</code> in <code>BetterBright.ini</code>. You can change the position, colour, size and language of the OSD by editing <code>BetterBright.ini</code>. It remembers the level you chose and re-applies it after returning to the XMB, launching a game, rebooting, or (usually) waking from sleep. == Configuration == <code>BetterBright.ini</code> example - leave empty to use the defaults. IPS or after market screens will need to play around with these: <pre># --- BEGIN: List each custom brightness level on each below --- 28 40 50 70 90 99 # ---------------------------------------------------------------</pre> * One brightness value per line, <code>0</code>-<code>100</code>. <code>0</code> = backlight off, <code>100</code> = full (<code>99</code> is the max for PSP-1000/2000 with OEM display, this may vary further for after market screens) * Only one whole number per line <code>0</code>-<code>100</code> are accepted; blank lines, <code>#</code> comments and any malformed line are ignored. * '''Leave the list empty''' to cycle a built-in default range chosen for your model (PSP-1000, 2000 and 3000/Go, each get their own list). Set <code>oem_brightness_levels=1</code> (below) to instead cycle only the four stock backlight steps. <code>combo_mode</code> - Adjust scheme (the plain Display button always cycles regardless): {| class="wikitable" |- ! value ! scheme |- | <code>0</code> | off (Display button cycling only) |- | <code>1</code> | hold a trigger + tap Display: '''R = brighter, L = dimmer''' (this is the default in the included <code>.ini</code>) |- | <code>2</code> | hold both triggers + tap D-pad: '''Up = brighter, Down = dimmer''' (hold to ramp) |} Both schemes stop at the dimmest/brightest end of your list (no wrap-around). In mode <code>2</code>, holding the D-pad auto-repeats/ramps through the levels. <code>dim_level</code> - how dim the screen goes when the PSP idles. <code>AUTO</code> (default) uses the second-lowest value in your list; or set a specific <code>0</code>-<code>100</code>. Only has an effect when <code>keep_display_on=0</code>. <code>keep_display_on</code> - keep the screen always on. <code>1</code> = on, <code>0</code> = off (default). <code>disable_sleep</code> - stop the PSP from auto-sleeping on its own. Manual sleep (the power switch) still works. <code>1</code> = on, <code>0</code> = off (default). Use with caution - the console will never automatically sleep when enabled. <code>osd_bg_colour</code> / <code>osd_text_colour</code> - the plate and text colours of the OSD. Defaults are <code>1</code> (black background) and <code>2</code> (white text). Set <code>osd_bg_colour=0</code> for no background. {| class="wikitable" |- ! value ! colour ! value ! colour |- | <code>1</code> | Piano Black | <code>10</code> | Lilac Purple |- | <code>2</code> | Ceramic White | <code>11</code> | Blossom Pink |- | <code>3</code> | Champagne Gold | <code>12</code> | Rose Pink |- | <code>4</code> | Ice Silver | <code>13</code> | The Simpsons (Yellow) |- | <code>5</code> | Mint Green | <code>14</code> | Spirited Green |- | <code>6</code> | Felicia Blue | <code>15</code> | Turquoise Green |- | <code>7</code> | Vibrant Blue | <code>16</code> | Matte Bronze |- | <code>8</code> | Radiant Red | <code>17</code> | Deep Red |- | <code>9</code> | Metallic Blue | <code>18</code> | Lavender Purple |- | <code>0</code> | AliExpress Clear Replacement Housing Shell (no background) | | |} <code>osd_size</code> - text size: <code>1</code> = 1x (normal), <code>2</code> = 2x, <code>3</code> = 3x, <code>4</code> = 4x. <code>osd_position</code> - <code>1</code> = bottom (default), <code>2</code> = top. <code>osd_detect_locale</code> - show the OSD "Brightness Level" label in your system language (<code>1</code>, default) or always in English (<code>0</code>). <code>osd_draw_mode</code> - how the OSD is drawn. <code>0</code> = auto (default): draw on the frame the game presents, and automatically fall back to drawing the live framebuffer for games that don't drive that path. <code>1</code> = API hook only <code>2</code> = poll only (always draw the live framebuffer). Auto (default) covers virtually every game/app. <code>sync_fw_level</code> - keep the firmware's own backlight level (the four stock steps the Display button normally cycles) in step with your brightness, rounded up to the nearest step. Your actual brightness is unchanged - it just keeps the firmware's internal level more consistent with yours. <code>1</code> = on (default), <code>0</code> = off. <code>oem_brightness_levels</code> - only applies when the brightness list above is '''empty''' (ignored if you list your own values). <code>0</code> (default) cycles the built-in default range for your model; <code>1</code> cycles only the four stock backlight steps - the original <code>L=</code> levels (2000: <code>36/44/56/68</code>, 3000/Go: <code>44/60/72/84</code>, 1000: <code>20/40/60/80</code>). '''Intended for aftermarket LCD panels.''' <code>debug_enable</code> - diagnostics, for troubleshooting. <code>0</code> = off (default). <code>1</code> = an on-screen debug line on every brightness event (press/combo/dim/wake/idle) showing the <code>sceDisplayGetBrightness level</code>, user level, the event, and how the OSD is being drawn. <code>2</code> = everything in <code>1</code> plus a verbose <code>BetterBright.log</code> next to the plugin. Note: Max brightness will drain the battery faster! Use at your own risk. == Screenshots == https://dlhb.gamebrew.org/psphomebrew/images/BetterBrightPSP2.png https://dlhb.gamebrew.org/psphomebrew/images/BetterBrightPSP3.png https://dlhb.gamebrew.org/psphomebrew/images/BetterBrightPSP4.png https://dlhb.gamebrew.org/psphomebrew/images/BetterBrightPSP5.png == Known issues == * Waking from sleep above ~84 (factory max) can still drop back to firmware max * A few games may still flicker the OSD slightly (e.g. Lego Batman). * Tested on a PSP-3000 (09g) and a PSP-2003, stock LCDs - other models/screens may need different values. == Compatibility == Developed for 6.61, ARK-4 / FasterARK. Other 6.61 CFW should work (untested); should work fine with 6.60. == Changelog == '''v0.93''' * '''Fixed max brightness snapping to lowest on wake''' - when waking from dim at the highest level, the firmware's brightness bump could be misread as a Display press and wrap all the way round to the lowest level; a wake guard now treats that bump as a restore. * '''Fixed a crash when exiting to XMB''' - in games that use the poll-draw method, having the OSD active on exit could write into a framebuffer as it was being torn down and reboot the PSP; the poll-draw thread now pauses briefly across the game↔XMB switch to prevent it. * '''Tighter OSD spacing''' - trimmed the gap after the colon in "Brightness Level: NN" for Latin languages. '''v0.92''' * '''Per-model default levels''' - leave the brightness list empty and you get a sensible range tuned to your model (PSP-1000, 2000, 3000/Go each have their own), now starting at '''0''' (backlight off). * '''<code>osd_bg_colour=0</code>''' - Option for transparent / no background for the OSD * '''<code>oem_brightness_levels</code>''' - new flag: with an empty list, cycle ''only'' the 4 stock backlight steps (the original <code>L=</code> levels). Intended for aftermarket LCD panels. * '''OSD label is now "Brightness Level: NN"''' - still localised into your system language, incl. Japanese (明るさレベル), Korean, Chinese, Russian. * **OSD sizes 1×–3x * '''PSP-2000 fix''' - no longer need to press the Display button twice to change level (model-aware step detection). * '''combo_mode 2 (L+R + Up/Down)''' - now auto-repeats when held, and L/R + Display no longer does anything in this mode (triggers are reserved for the combo). Also fixed the stray memory-stick writes. * '''Debug mode''' fixes osd bug where it would still sometimes show regular osd * <code>detect_locale</code> renamed to '''<code>osd_detect_locale</code>''' '''v0.91''' * '''OSD now shows in (almost) every game''' - auto-falls back to a second draw method for titles the old one missed (e.g. GTA: LCS). * '''Localised OSD''' - "Brightness: NN" in your system language, incl. Japanese (明るさ), Korean, Chinese, Russian (<code>detect_locale=0</code> for English). * '''OSD sizes 1×–3×''' (was just normal / 2×). * '''Leave the brightness list empty''' to just cycle your model's 4 stock steps. * '''Crash fix:''' quitting a game with the OSD up no longer reboots the PSP. * '''<code>sync_fw_level</code>''' (on by default) keeps the PSP's own backlight level in step with yours. * Better debug/logging (<code>debug_enable=2</code>). '''v0.4''' * Initial release. == Credits == * hobbo91 - BetterBright. * hiroi01 - bright3 (the plugin this is loosely based on). * plum - the original bright. == External links == GitHub - https://github.com/hobbo91/BetterBright