Return to light-desktop-usage.mdwn CVS log

Up to [NetBSD Developer Wiki] / wikisrc / light-desktop

Annotation of wikisrc/light-desktop/light-desktop-usage.mdwn, revision 1.5

1.1       wiki        1: This page gives a brief overview of the light-desktop features. It is a quick getting started guide.
                      2: 
                      3: ## Run it
                      4: 
                      5: * Currently the main packages are in pkgsrc-wip.
                      6: 
                      7: * Install the wip/light-desktop metapackage. On NetBSD, this will also install the netbsd-light-desktop-default-settings package.
                      8: 
1.4       wiki        9: * It uses DBUS:  /etc/rc.d/dbus start
                     10: 
1.5     ! wiki       11: * The desktop file monitoring uses FAM:  /etc/rc.d/rpcbind start; /etc/rc.d/famd start  **or build glib2 with kqueue support**
1.1       wiki       12: 
                     13: * Run it via your .xinitrc or .xsession:  start-netbsd-light-desktop
                     14: 
1.2       wiki       15: (One known issue depends on glib2 version. An unlock of already unlocked mutex. Reported upstream. See [[light-desktop-todo]].)
1.1       wiki       16: 
1.5     ! wiki       17: ## Test it
1.3       wiki       18: 
                     19: * Install xephyr or xnest and run it with the ":5 -ac" switches.
                     20: * export DISPLAY=127.0.0.1:5
                     21: * start-netbsd-light-desktop
                     22: 
1.1       wiki       23: ## Introduction
                     24: 
                     25: * The pcmanfm file manager controls the desktop. Files in ~/Desktop are displayed as icons.
                     26: * .desktop files in the ~/Desktop are used as application launchers.
                     27: * The window manager is openbox; but right click menu is controlled by pcmanfm by default.
                     28: * Right-click on desktop can choose Desktop Preferences which can change wallpaper and more.
                     29: * The taskbar aka panel is on the bottom.
                     30: * Left button on taskbar is the menu.
                     31: * Right-clicking on a menu entry gives you the option to add to the desktop.
                     32: * .desktop files installed on system should be automatically used for menu entries.
                     33: * To add menu entry, just add foo.desktop file to ~/.local/share/applications/.
                     34: * To change menu entries (or categories), go to menu of applications, and right click on item and choose Properties. (This runs the
                     35: lxshortcut editor.)
                     36: * The Run command will change icon and do type-ahead if it recognizes beginning of command entered.
                     37: * Right click on the panel for "Panel Settings".
                     38:   * Panel settings allow you to resize and position the panel, change its appearance, added choices to the panel, and more.
                     39:   * You can have multiple Application Launch Bars on the panel which can be configured to add various applications for quick launch via button on panel.
                     40: * The panel also has launchers for file manager and browser; minimize all button, pager, taskbar, clock, and shutdown button.
                     41: * The Monitor Settings via Preferences on menu offers a xrandr-based GUI.
                     42: 
                     43: Running programs are:
                     44: 
                     45: * dbus-daemon
                     46: * dbus-launch
                     47: * openbox
                     48: * pcmanfm
                     49: * menu-cached
                     50: * lxsession
                     51: * lxpanel
                     52: 
                     53: Various keys are custom controlled by openbox. Not tested yet and has some controls not installed yet.
                     54: 
                     55: ## Normal Desktop
                     56: 
                     57:  *This is not complete yet*
                     58: 
                     59: The reference implementation of the desktop also offers:
                     60: 
                     61: * nm-applet embedded in notification area; to show and configure wired and wireless connections and detected networks.
                     62: * xfce4-power-manager to show battery state in notification area.
                     63: * shutdown button runs logout gui: suspend, hibernate, logout, cancel
                     64: 
                     65: The reference implementation of the desktop also runs:
                     66: 
                     67: * xscreensaver
                     68: * policykit-1-gnome/polkit-gnome-authentication-agent-1
                     69: * /usr/lib/xfce4/xfconf/xfconfd
                     70: * gvfsd
                     71: * update-notifier
                     72: * notification-daemon
                     73: * gvfs-fuse-daemon
                     74: * gconfd
                     75: * gvfs-gdu-volume-monitor
                     76: * gvfs-afc-volume-monitor
                     77: * gvfs-gphoto2-volume-monitor