File:  [NetBSD Developer Wiki] / wikisrc / light-desktop / light-desktop-usage.mdwn
Revision 1.6: download - view: text, annotated - select for diffs
Sat Jun 2 14:09:12 2012 UTC (10 years, 6 months ago) by wiki
Branches: MAIN
CVS tags: HEAD
web commit by reed: about file monitoring

    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: 
    9: * It uses DBUS:  /etc/rc.d/dbus start
   10: 
   11: * The desktop file monitoring needs glib2 built with kqueue support or as an alternative uses FAM (install gio-fam, and run /etc/rc.d/rpcbind start; /etc/rc.d/famd start)
   12: 
   13: * Run it via your .xinitrc or .xsession:  start-netbsd-light-desktop
   14: 
   15: (One known issue depends on glib2 version. An unlock of already unlocked mutex. Reported upstream. See [[light-desktop-todo]].)
   16: 
   17: ## Test it
   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: 
   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

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb