Added category mapping support to mmenu .. lets user define what categories to have...
[pandora-libraries.git] / deployment / etc / pandora / conf / mmenu.conf
index 26d4e07..f15336b 100644 (file)
@@ -1,6 +1,9 @@
 # for the mmenu 'minimenu'
 #
 
+# 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
+
 [minimenu]
 static_art_searchpath  /etc/pandora/mmenu/skins/default:./minimenu/skin/default
 font                   Vera.ttf
@@ -8,8 +11,17 @@ font_ptsize           24
 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    1       # if >0, will try to load preview pics sometime (see defer_timer_ms as well)
+load_icons_later       1       # 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       1       # 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?
+
+[utility]
+terminal               /usr/bin/Terminal       # could also be /usr/bin/xterm, or a sh-script, or whatever
 
 [display]
 fullscreen             1       # 0 for windowed, >0 for fullscreen
@@ -21,7 +33,7 @@ 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
+hintline               Push SELECT for shutdown options # shown at bottom of screen
 hint_x                 275     # (x,y) for hint line
 hint_y                 450     # (x,y) for hint line
 clock_x                        650     # (x,y) for clock
@@ -40,10 +52,11 @@ 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
+tab_height             35      # height of tab (for vertical clip)
+tab_selheight          39      # height of tab when its selected (for vertical clip)
 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
+text_width             110     # clip text to this width
 
 [grid]
 font                   Vera.ttf
@@ -105,8 +118,28 @@ IMG_SELECTED_ALPHAMASK   select.png
 IMG_SELECTED_HILITE     hilite.png
 IMG_TAB_SEL              tab_sel_tall.png
 IMG_TAB_UNSEL            tab_unsel.png
+IMG_TAB_LINE            tabline.png    # line under the unselected tab, but not left/right corners
+IMG_TAB_LINEL           tablinel.png   # line under unselected tab on far left
+IMG_TAB_LINER           tabliner.png   # line under unselected tab on far right
 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
+
+[categories]
+# Normally for mmenu, an encountered category is just used as is. 5 cats exist, you get 5 tabs.
+# If map_on is >0, then category transforms will occur
+#   @NEWCAT oldcat1:oldcat2     <- means oldcat1, if found, will map to NEWCAT. "@" is discarded.
+#   NOTE: FreeDesktop rules do not allow categories with spaces in the name; if needed, I can add it with quoting.
+# If map_default_on is set (>0), then any unmapped categories will be forced into the default category bucket (map_default_cat.)
+#   If map_default_on is off (=0), then unmapped categories will become their own categories as normal.
+#   Should probably still have an @ line to create the default category, since creating the cats comes before assigning defaults
+# NOTE: Individual app overrides occur at the time of app scanning, so before this category mapping occurs and thus is effected
+map_on                 0               # if >0, will do category mapping at all; if 0, don't do any of this.
+map_default_on         0               # if >0, any unmapped category will get forced to map_default_cat; set to 0 to leave unmapped cats alone
+map_default_cat                Spam            # see map_default_on
+# NOTE: List the categories in reverse order to how you wish them in the tab list; last one shows up as first tab
+@Woogle                        Audio
+@Jimmy                 Game
+@Spam