Notable features & Quick instructions:
Installation:
- (OPTIONAL) format sd card to fat16
- Place _bagui folder on root of card
- Copy DSTwo.nds and boot.ini to _dstwo folder on root of card
-(OPTIONAL) Configure emulator support via arg files (See "Adding new file support:" below). Binary locations may need
to be updated to their current path on your card.
Skinning support:
-png files, 8 bit, 16 bit, 24 bit and 32 bit bitmap files
*NOTE* backgrounds must be 16 or 24 bit bmp so fast rendering can be used for a smoother browser
-Windows and sub windows are just color codes defined via the skin.ini file. These color values are 16 bit colors, the included ColorConvert.exe program can be used for
converting 24 bit RGB color values to 16 bit color values (PA_RGB in the program)
Custom icons:
-uses 32 x 32 bitmap files
-must be named the same as the file with a .ico extention in the same directory eg OR they can be placed in a directory as defined in the current skin.ini under "Custom_Icon_Folder".
eg:
BAGSFC.plg - the file you want to have a custom icon
BAGSFC.ico - the icon file
Game Covers
- can be any size as long as it fits on screen
- can be either png or bmp files
- must be named exactly the same as the game file excluding the file extension
-CoverArt.ini file must be present in game directory
- ini file example:
**********************
[Cover Art]
#path to folder with covers
folder = /_bagui/cover art/nds
#image type
type = png
**********************
Media Player:
-Mp3, Ogg, Wav supported.
-All songs in current directory as the current song being played are automatically queued for automatic track changes
-Music player can be backgrounded (Press X or the backgrounding icon) for file browsing while listening to tunes
Settings menu:
-Allows to instantly swap skins with no rebooting
-Contains settings for various display options (show all file types, show file extensions, hide folders, open last folder, enable or disable short names in the favorites menu)
*NOTE* Hidden folders are defined by the first character in the folder name. folder_hide_val in the settings.ini can be changed to reflect which character to use.
Default is the underscore ( _ ) character to denote hidden folders
Supported File formats:
-Standard supported files include PLG, NDS (homebrew and commercial via EOS 1.11), SNES file formats (including zip archives), Mp3, Wav, Ogg.
-New file formats can be added via arg files (in /_bagui/ext folder) for programs which can accept boot args
-File formats can be set to open in multiple different programs
--eg: a zip file can contain a snes rom or a gba rom, a pop up will come up and ask which program to launch said file in. This program list can be edited in the arg files for the specified file type
Adding new file support:
Programs that support launch arguements can be used open specific files selected within BAGplug. For example an emulator such as nesDS which can open .nes files.
*Example setup using nesDS*
First, a .arg file must be created in /_bagui/ext/ which will contain the instructions for launching .nes files within the menu.
The name format of .arg files is quite simply the extension of the file format to support with a .arg extension. In this case, the file will be called "nes.arg".
Format of .arg files
nesDS://Title of the program
"/ _bagui / NesDS / nesDS.nds" / / file path to the program binary
[$PRGMPATH$,$FILEPATH$]//launch arguments
;
- $PRGRMPATH$ will pass on the file location of the launched program to the program itself, this is standard.
- $FILEPATH$ will pass on the rom location from the menu to the program, this is what is needed for the program to load the correct file.
- There are no limits as to how many arguements to pass on to a program however the program will only take what it needs.
- Order of args may vary depending on programs, so be sure to watch out for that
More than one program can be added to a .arg file. When the file is launched, the open with dialog will open allowing you to choose which program to use. See smc.arg for an example
Favorites menu:
-Any supported file type can be linked in this menu (snes roms, zip files, nds roms, image files, ogg and wav files, etc)
-Favorites list is just a text file containing file paths to all the files you want to save for quick launching
-Can add files to the favorites list via the normal browser, or remove files within the favorites menu (select button)
Copy/Cut/Paste/Delete
-Pressing /select/ on a file or folder brings up the file operations menu where you can selected an option
-Files will be pasted in the current directory you are browsing regardless of what is high-lighted
Input:
-All menu have some sort of pad and stylus input
-if L and R buttons are pressed, you can take a screenshot of the both screens
Change log:
Release 2 - 3
-fixed freezing when accessing an empty favorites list
-favorites menu now ignores blank lines in the favorites.txt
-fixed glitch with music playing and the file options menu
-fixed issue with internal nds names while listening to music
-fixed a bug where the stylus couldn't select bottom half of files in directories with few files/folders
-can now use left and right on the d-pad to select cpu frequency in options
-fixed a bug in shortening names with more than one '.'
Release 2 - 5:
-added Properties menu which contains info on file types, size and for nds roms, the game ID
-fixed memory corruption in nds internal name caching
-other tiny fixes
Release 2 - 4:
-fixed backgrounding and returning from media player in sub menus
-fixed memory leak in song loading
-added 24 hour clock option
-fixed nds internal names
-fixed the day display on the clock
-covers are now loaded in the favorites menu
-fixed a memory leak with favorites icons
-included a font creation program - dsFont
Release 2 - 2:
-fixed a small memory leak
-added the option to display internal nds file names
-fixed division by 0 error when in favorites menu with exactly 15 favorites
-fixed cursor flickering issue
Release 2 - 1:
- nds covers are now identified using game id's
Release 2:
-increase max files per folder to 1024 and max folders to 64
-fixed a memory leak in skin listing
-fixed menu icons updating on skin changes
-improved file icon handling, common icons are now cached when loaded
-added page scrolling in main browser using left and right on the d-pad
-fixed png support for graphics
-added the option change cpu settings for various menu portions
-improved windowing
-stylus & pad support for all menus
-fixed media player freeze when launching audio from root directory
-added cut, copy, paste actions to filebrowser
-can now add and remove favorites
-changed background music controls (L and R now change tracks)
-added mp3 support to media player
-added ability to have a background for the favorites menu
-added scrolling to the favorites menu
-added ability to enable or disable short names in the favorites menu
-media player is now fully customizable
-added commercial rom support via EOS 1.11
-CATSFC has been added as an alternative choice for snes games
-much faster file sorting
-custom icons can be set to be loaded from a folder on a per skin basis
-can now hide or display file extensions
-fixed various issues with windows and flickering
-added top screen background
-added cover art display on top screen
*Notes*
FAT16 is highly recommended over FAT32 (if possible) for a considerable speed boost in loading and browsing. The Supercard seems to support FAT16 using 64kb clusters which should cover sd cards up to 4gb.
Release 1:
initial release
