Modifying DSOrganize
From DSOrganize Wiki
While I do not want people mucking around with the DSOrganize source code, I heavily encourage you to customize your DSOrganize experience. There are several ways to modify DSOrganize to better fit your style.
Contents |
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:
- name - The name of the shortcut. This field will show up as the three line description in the browser, or above the shortcut on the home screen.
- file - A complete unix path to the file you want to link to.
- largeicon - A complete unix path to a 50x50 bmp/gif/png/jpg file that will be used as the icon on the homescreen. If this isn't present, DSOrganize will use the default icon for that particular file.
- alternate - Simply place this word on it's own line to make the shortcut load the alternate action for the file pointed to, such as editing a .html or booting with an alternate loader.
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.
