Added option to set starting category to minimenu (default is still leftmost (usually...
[pandora-libraries.git] / minimenu / mmenu.conf
index 77571b7..6028084 100644 (file)
@@ -1,31 +1,39 @@
 # for the mmenu 'minimenu'
 #
 
+# Note on overriding whats in a .pnd-application/PXML.xml
+# Note that you can perform icon name, clockspeed setting and category overrides via an .ovr file
+# Note that the icon can be overridden for a pnd-file by making a same-name .png file, in the same location
+# "Notes" can be added to an icon using the .ovr file, as well.
+
+# Skins
+# There is a a searchpath to find skin subdirs in; built in skins are in /etc/pandora/mmenu/skins,
+# so any subdirectory of that is a skin-name. (ie: /etc/pandora/mmenu/skins/default is skin named 'default')
+# Each skin will have its own mmskin.conf file defining how the skin works. All other options should be
+# here, so that skin-changes do not break user preferences
+
 [minimenu]
-static_art_searchpath  /etc/pandora/mmenu/skins/default:./minimenu/skin/default
-font                   Vera.ttf
-font_ptsize            24
+skin_searchpath                /media/*/pandora/mmenu/skins:/etc/pandora/mmenu/skins:./minimenu/skin
+skin_selected          ~/.mmenuskinchoice
+skin_confname          mmskin.conf
 pndrun                 /usr/pandora/scripts:./testdata/scripts # searchpath to locate "pnd_run.sh"; why aren't I looking in /etc/pandora/conf/apps for this?
 load_previews_now      0       # if >0, will try to load preview pics from pnds at boot time, not defer till later
 load_previews_later    0       # if >0, will try to load preview pics sometime (see defer_timer_ms as well)
+load_icons_later       0       # if >0, will try to load icons after grid is showing, not during app scanning
+defer_icon_us          100000  # when background loading icons (load_icons_later), time between icon loadsa
+threaded_preview       0       # if 1, will try to load the preview in background, to avoid slowing up navigation
 loglevel               0       # 0 is debug, lots of crap; 3 is better, means 'errors only'. Output may screw up the wrapper!
+x11_present_sh         /bin/pidof X # command to invoke to determine if X11 is running or not; expects a number on X is present.
+desktop_apps           1       # search the pnd standard desktop searchpath for apps
+menu_apps              1       # search the pnd standard menu searchpath for apps
+aux_searchpath         /media/*/pandora/mmenu # if something here, also search this path; can be used for mmenu-only apps?
 
-[apps]
-searchpath             ./testdata/app2:./testdata/app3:/media/*/pandora/desktop
+[utility]
+terminal               /usr/bin/Terminal       # could also be /usr/bin/xterm, or a sh-script, or whatever
 
 [display]
 fullscreen             0       # 0 for windowed, >0 for fullscreen
 screen_width           800     # for some calculations
-detail_bg_alpha                100     # when rendering the detail panel background, how transparent?
-font_rgba_r            220     # RGBA for the display text
-font_rgba_g            220     # RGBA for the display text
-font_rgba_b            220     # RGBA for the display text
-font_rgba_a            20      # RGBA for the display text
-battery_x              10      # (x,y) for battery level
-battery_y              450     # (x,y) for battery level
-hintline               Push START for shutdown options # shown at bottom of screen
-hint_x                 300     # (x,y) for hint line
-hint_y                 450     # (x,y) for hint line
 
 [tabs]
 top_maincat            1       # include maincat in top tab bar
@@ -35,74 +43,30 @@ top_altcat          1       # include alt cat in top tab bar
 top_altcat1            0       # include alt cat subcat 1 in top tab bar
 top_altcat2            0       # include alt cat subcat 1 in top tab bar
 wraparound             0       # if 1, last tab wraps around to first when going right; going left from first tab goes to last
-font                   Vera.ttf
-font_ptsize            16
-tab_offset_x           4       # from left screen to first tab left
-tab_offset_y           3       # from top of screen to first tab top
-tab_width              132     # width of tab
-tab_height             35      # height of tab
-text_offset_x          10      # from left edge of tab to left edge of text
-text_offset_y          10      # from top edge of tab to top edge of text
-text_width             120     # clip text to this width
 
 [grid]
-font                   Vera.ttf
-font_ptsize            12
-icon_max_width         60      # scale icons to..
-icon_max_height                60      # scale icons to..
-grid_offset_x          17      # from left screen to first cell column
-grid_offset_y          60      # from top screen to first cell row
-icon_offset_x          12      # from left edge of cell to left edge of icon in cell
-icon_offset_y          0       # from top edge of cell to top edge of icon in cell
-text_offset_x          42      # from left edge of cell to center of text centering (ie: center of icon presumably)
-text_offset_y          65      # from top of cell to top of text
-text_width             75      # max width of the text
-text_clip_x            5       # offset from cell edge to left edge of text, when the text width is being clipped to fit
-cell_width             85      # cell location is grid_offset_x + ( cell_width * column_number )
-cell_height            92      # cell location is grid_offset_y + ( cell_height * column_number )
-col_max                        5       # number of columns to render into grid
-row_max                        4       # number of rows to display before we stop rendering
-text_hilite_offset_y   62      # from top of cell to top of hilight
 scroll_increment       4       # number of rows to scroll when jumping up or down (recommend 1, or same as row_max for full page jump)
-arrow_up_x             450     # left edge of up-arrow showing more icons scrolled away
-arrow_up_y             80      # top edge of up-arrow showing more icons scrolled away
-arrow_down_x           450     # left edge of down-arrow showing more icons scrolled away
-arrow_down_y           380     # top edge of down-arrow showing more icons scrolled away
-arrow_bar_x            455     # left edge of scrollbar
-arrow_bar_y            100     # top edge of scrollbar
-arrow_bar_clip_w       10      # clip scrollbar artwork to width-X
-arrow_bar_clip_h       274     # clip scrollbar artwork to height-X
-
-[detailpane]
-show                   1       # if 0, don't show detail pane artwork at all
-pane_offset_x          475     # left edge of detail pane graphic
-pane_offset_y          60      # top edge of detail pane graphic
-
-[detailtext]
-font                   Vera.ttf
-font_ptsize            16
-cell_offset_x          488     # left edge of text cell
-cell_offset_y          312     # top edge of text cell
-cell_width             250     # width of cell (for text clipping)
+wrap_horiz_samerow     1       # if 0, wraps to prev/next row; if 1, stays on same row
+wrap_vert_stop         0       # if 0, wrap to other end; if 1, stops at top/bottom
 
 [previewpic]
-defer_timer_ms         1000    # after setting selection, how long to wait before we try to load the previewpic
-cell_offset_x          480     # left edge of text cell
-cell_offset_y          90      # top edge of text cell
-cell_width             285
-cell_height            180
+defer_timer_ms         1500    # after setting selection, how long to wait before we try to load the previewpic
+do_cache               1       # if 1, will try to cache previews to SD, for performance boost
+cache_searchpath       /media/mmcblk[12]p?        # devices to consider for caching to, in order
+cache_minfree          500             # if free space is less than this (in KB), move to next device
+cache_path             /pandora/appdata/mmenu.pvwcache              # where to write cached images to
+cache_findpath         /media/mmcblk[12]p?/pandora/appdata/mmenu.pvwcache           # where to look for cached preview pics
+
+[categories]
+catmap_searchpath      /media/*/pandora/mmenu:/etc/pandora/mmenu:./minimenu
+catmap_confname                mmcatmap.conf
+do_all_cat             1       # if >0, will show an All category; if 0, skip it, just your cats.
+#default_cat           Game
 
-[graphics]
-IMG_BACKGROUND_800480    800480_6.png
-IMG_BACKGROUND_TABMASK   tab1mask.png
-IMG_DETAIL_PANEL         detailpane2.png
-IMG_DETAIL_BG            800480_4.png
-IMG_SELECTED_ALPHAMASK   select.png
-IMG_SELECTED_HILITE     hilite.png
-IMG_TAB_SEL              tab_sel_tall.png
-IMG_TAB_UNSEL            tab_unsel.png
-IMG_ICON_MISSING        pandora60.png
-IMG_PREVIEW_MISSING     pandora60.png
-IMG_ARROW_UP            arrowup.png
-IMG_ARROW_DOWN          arrowdown.png
-IMG_ARROW_SCROLLBAR     arrowscroller.png
+[filesystem]
+do_browser             1       # if >0, will allow filesystem browsing somehow
+tab_searchpaths                /media/*        # for each chunk in searchpath, show a tab (if not empty).
+# example:
+# /media -> show /media as a single tab
+# /media/* -> show a tab for each dir in /media
+# /media/mmcblk1p1:/media/mmcblk2p1 -> show 2 tabs, one for first partition on each SD