Modifying DSOrganize

Shortcut Files

You can place shortcut files inside any directory on your media card to make your file system appear neater. Coupled with hidden directories, this can be used to create a very similar experience to the Start Menu on a Windows machine, among other things. If shortcut files are placed inside the Home directory, they will appear on page three of the home screen. The format for DSOrganize shortcut files is shown below:

The first line of any shortcut must simply contain "dsoshortcut" After that, the shortcut format is flexible, so order is not important and not every field is mandatory. Edit a shortcut like a .ini file, using field=value as the format. Other fields are shown below:

A sample .dss file is shown below:

DSOSHORTCUT
name=My Favorite Song
file=/music/modules/class 10.mod
largeicon=/licon2.bmp

Alternate Languages

Alternate languages are available through the Languages page. They also come pre-packaged with DSOrganize if you have done a proper install. Langauge files allow you to modify DSOrganize to use your native language and keyboard layout to make it easier to use.

Color Modifications

Colors inside DSOrganize can be customized to however you like it. Virtually every text, foreground, background, border, highlight and other color inside DSOrganize can be changed. There is a sample colors.ini file with the default DSOrganize distribution. To start editing it, rename colors.ini.sample to colors.ini and start adjusting values. DSOrganize colors are 16bit hexidecimal values. These are similar to the normal web colors you see, but instead of 8 bits per color, the Nintendo DS only uses 5 bits per color. You do not need to set bit 15 on your colors as DSOrganize insures that it is set for you. If you need a converter tool, grab RGB15. Do not include the initial 0x in your colors. DSOrganize expects a 4 character color.

Icon Customization

The default iconset for DSOrganize can be overridden with a custom iconset. These are fairly easy to create. Simply make a new directory inside the icons directory, and place all of your image files there. These files will show up as an iconset selection in the Configuration screen named after the directory you created. Iconset directories can also include their own colors.ini file to supply a color theme that goes with the iconset. You can save the files in any image format that DSOrganize recognizes, including jpg, gif, bmp and png. DSOrganize does not support animated icons. Transparency is achieved with the color purple (RGB 255, 0, 255). The names of the image files as well as their required dimensions are shown below:

Home Screen Icons

These icons are for the home screen, and must all be 50x50.

home_unavailable
home_scribble
home_calendar
home_dayplanner
home_address
home_todo
home_browser
home_calculator
home_irc
home_webbrowser
home_hbdb

These icons are for the home screen, and must be 40x20.

home_back
home_next

Configuration Drag Icons

These icons are for the drag and drop home screen customization page inside Configuration. They are expected to be 32x32.

drag_scribble
drag_browser
drag_calculator
drag_irc
drag_webbrowser
drag_hbdb

Browser Large Icons

These icons show up in the top left box in the browser, and on home screen shortcuts that do not have an image linked to them. They should be 32x32.

browser_ndslarge
browser_unknownlarge
browser_folderlarge
browser_addresslarge
browser_dayplannerlarge
browser_calendarlarge
browser_textlarge
browser_picturelarge
browser_todolarge
browser_soundlarge
browser_playlistlarge
browser_homebrewlarge
browser_cantloadlarge

Browser Small Icons

These icons show up on the left inside the file list on the browser. They should be 10x10.

browser_foldersmall
browser_addresssmall
browser_dayplannersmall
browser_textsmall
browser_calendarsmall
browser_unknownsmall
browser_ndssmall
browser_todosmall
browser_picturesmall
browser_soundsmall
browser_playlistsmall
browser_homebrewsmall
browser_shortcutsmall

Tabs Icons

These show up on the tabs inside the IRC Client and Web Browser. They should be 19x18.

tabs_keyboard
tabs_favorites
tabs_special
tabs_capturedurls
tabs_colors
tabs_nicks

Configuration Icons

These show up as the tab icons inside the configuration screen. They should be 16x16.

config_global
config_home
config_scribble
config_todo
config_editor
config_browser
config_irc
config_web
config_wifi

IRC Customization

The irc.ini file allows you to customize the look of IRC. The system used is similar to the format of printf/sprintf/fprintf in C/C++ with the exception that there are numbers that allow you to specify order. It is possible to modify the look of any message inside DSOrganize IRC, including adding colors, timestamps, and tab indents. The irc.ini file should be self-explanitory and is found inside the DSOrganize data directory.