FVWMCrystalFAQ(1)                FVWM-Crystal                FVWMCrystalFAQ(1)

       FVWM-Crystal - FAQ

       Frequently Asked Questions for FVWM-Crystal

       Last updated: 30.04.2013, for version 3.1.7

       1.  General information.

            1.1: What is FVWM-Crystal?
            1.2: Who are the authors?
            1.3: Where I can get the newest version?
            1.4: Is there a mailing list?

       2.  Installation.

            2.1:  What do I need to install FVWM-Crystal?
            2.2:  Can I use FVWM-Crystal with "stable" FVWM branch (2.4.x)?
            2.3:  How to install FVWM-Crystal from distributed packages?
            2.4:  How to install FVWM-Crystal from darcs repository?
            2.5:  How to install FVWM-Crystal manually?
            2.6:  How I can select FVWM-Crystal as my window manager?
            2.7:  When I start FVWM-Crystal I get only the empty FVWM desktop...
            2.8:  Why there is no application panel on the desktop?

       3.  Usage.

            3.1: Where can I start some prefered application at startup?
            3.2: Where can I add my prefered fvwm command?
            3.3: How can I have a tear off menu?
            3.4: How can I record madias with mplayer?
            3.5: The Music menu get screwed. What can I do about this?
            3.6: Mplayer doesn't show the movie I selected into the menu. Why?
            3.7: Mplayer is flaky. What can I do?

   Q 1.1: What is FVWM-Crystal?
       A: It's a set of FVWM configuration files, some Python and shell
       scripts, a set of application icons and images. This combination
       produces a fairly decent and customized Linux window manager using FVWM
       as it's basic component. With additional file managers, such as ROX-
       Filer or Nautilus (from GNOME Project) you can create useable and good-
       looking Linux desktop environment.

   Q 1.2: Who are the authors?
       A: The initial author of FVWM-Crystal is Maciej Delmanowski. You can
       contact with him using his e-mail account <harnir@berlios.de> or
       through Jabber network <harnir@jabberek.net>.

       The current maintainer and developper is Dominique Michel

       FVWM-Crystal could not be in the present state without the help of
       other people. You can find their list in the AUTHORS file included in
       the project's package.

   Q 1.3: Where can I get the newest version?
       A: Newest stable version can be always found on the main FVWM-Crystal
       website: http://fvwm-crystal.sourceforge.net/. Some GNU/Linux
       distributions have already included packages, usually named 'fvwm-

       You can also use the development version. It is a subversion (svn)
       repository which contains the newest code. You can find more
       information on http://sourceforge.net/projects/fvwm-crystal/.

   Q 1.4: Is there a mailing list?
       A: Yes, there is. You can read the archives by pointing your web
       browser on http://lists.berlios.de/pipermail/fvwm-crystal-users/

       If you want to subscribe, you can do it using the Web interface:

   Q 2.1: What do I need to install FVWM-Crystal?
       A: If you want to use FVWM-Crystal, you need to have:

              ·  FVWM window manager, version 2.6.1+

              ·  Python interpreter

              ·  POSIX shell interpreter

              ·  an application which can set the desktop wallpaper (habak,
                 Esetroot, hsetroot)

       You can install these applications to get additional functionality:

              ·  terminal emulator (xterm, Aterm, Eterm, urxvt, mrxvt, gnome-
                 terminal, konsole, mgt, terminator or xfce4-terminal are
                 currently supported)

              ·  ImageMagick - for window thumbnails and making screenshots

              ·  XScreenSaver - a desktop screensaver

              ·  stand-alone notification area application - trayer and
                 stalonetray are supported

              ·  sudo - running text-based applications as superuser and for
                 shutdown/reboot commands (needs to be configured properly)

              ·  gksudo - for running graphical applications as superuser

              ·  GDM (gdmflexiserver) - for shutdown/reboot/new login commands

              ·  Xephyr - for nested sessions

              ·  a music player - audacious, cmus, mocp, mpd, XMMS, XMMS2 ,
                 QuodLibet, cdcd, alsaplayer, mplayer, mplayer2 or MPD are

              ·  graphical file manager - ROX-Filer or Nautilus

              ·  transset-df and xcompmgr - for true transparency support

              ·  gnome-session - for saving amd restoring of your FVWM-Crystal

       Here are URLs for applications specified above:

              - FVWM http://www.fvwm.org/

              - habak, trayer

              - stalonetray

              - Esetroot

              - hsetroot

              - Aterm

              - Eterm

              - URxvt

              - mrxvt

              - ImageMagick

              - XScreenSaver

              - sudo http://www.courtesan.com/sudo/

              - XMMS http://www.xmms.org/

              - XMMS2

              - xmms-shell

              - xmms-find

              - MPD  http://www.musicpd.org/

              - mpc  http://musicpd.org/mpc.shtml

              - alsaplayer

              - QuodLibet

              - cdcd http://libcdaudio.sourceforge.net/

              - ROX-Filer

              - gnome-session

   Q 2.2: Can I use FVWM-Crystal with old stable FVWM branch (2.4.x)?
       A: No. Old FVWM version is in fact, old. 2.5.x series has many
       improvements over the stable tree, for example support for PNG images,
       new modules, improvements in existing modules and bugfixes. From 2.6.1,
       FVWM doesn't offer stable and unstable version anymore. For the best
       experience with FVWM-Crystal, I strongly encurage you to install and
       use the newest stable version (2.6.1 at that time of writing).

   Q 2.3: How to install FVWM-Crystal from distributed packages?
       A: Unpack fvwm-crystal-X.Y.tar.gz to an empty directory. After that cd
       into unpacked directory and execute:

                       make install

       By default Crystal will be installed in /usr/local directory. You can
       select destination directory using:

                       make prefix=/usr install

       After successful installation you can copy sample ~/.Xresources file
       from "addons/" directory of the FVWM-Crystal package, if you don't have
       one. If you use GDM as your login manager, you can copy file
       "addons/fvwm-crystal.desktop" to /usr/share/xsessions, so you will be
       able to select FVWM-Crystal as your window manager.

   Q 2.4 How to install FVWM-Crystal from the subversion repository?
       A: You need to create a local copy of a subversion repository by
       issuing command:

                       svn co https://fvwm-crystal.svn.sourceforge.net/svnroot/fvwm-crystal fvwm-crystal

       When it finishes, cd into newly created 'fvwm-crystal/' directory and
       issue commands:

                       make install

       You can change the destination directory as described above.

   Q 2.5: How to install FVWM-Crystal manually?
       A: Parts of FVWM-Crystal configuration needs to have executable bit on,
       and it's set by the make script. If you can't or don't want to use it,
       you can installa FVWM-Crystal manually. Unpack the distributed package
       or get a darcs repository as described above, then issue commands

               cd fvwm-crystal
               chmod a+rx bin/*
               chmod -R a+rx fvwm/Applications
               chmod a+rx fvwm/scripts/FvwmMPD/*.py fvwm/scripts/FvwmMPD/*.sh

       Now put all files from 'fvwm/' directory in the chosen configuration
       directory. If you want to install FVWM-Crystal in your $HOME directory,
       put the configuration files in ~/.fvwm-crystal directory (without the
       'fvwm/' subdirectory!). Startup script will use them automatically.

       You can also copy ~/.Xresources or fvwm-crystal.desktop as described

       Before to run fvwm-crystal-generate-menu for the first time, be sure to
       read "Note on fvwm-crystal-generate-menu" and "Variables to check in
       fvwm-crystal-generate-menu" in FVWM-Crystal README file and follow the

   Q 2.6: How I can select FVWM-Crystak as my window manager?
       A: If you are using 'startx' for running your X session, copy file
       'addons/Xsession' from FVWM-Crystal package to your ~/.Xsession or
       ~/.xinitrc file. In other words, you need to start 'fvwm-crystal'
       script, 'fvwm' or 'fvwm2' will not work, because FVWM-Crystal has it's
       main configuration files in different place than FVWM.

       If you are using GDM login manager, just select "FVWM-Crystal" in the
       Session menu.

   Q 2.7: When I start FVWM-Crystal I get only the empty FVWM desktop...
       A: Make sure that you have correct path to the system-wide
       configuration files in 'fvwm-crystal' script. Also check if in your
       ~/.Xsession or ~/.xinitrc the last line contains 'exec fvwm-crystal'.
       Select "FVWM-Crystal" as your session in GDM, "FVWM" will not work.

   Q 2.8: Can I save-restore more as one previous FVWM-Crystal sessions?
       A: Short answer: No!

       Long story: Sure, you can. Launch gnome-session-properties as explained
       above (Menu "Quit" -> "Manage session"). In the first tab, add a new
       session with a new name (I.e.: FVWM-Crystal-games). You will find a new
       section with that name in '~/,gnome2/session'.

       If using gdm, make a new desktop file in '/usr/share/xsessions (I.e.:
       fvwm-crystal-games.desktop). The faster is to copy and rename fvwm-
       crystal.desktop. In this new file, edit the line that launch gnome-
       session with your new session name.

          I.e.: Exec=gnome-session --choose-session=FVWM-Crystal-games

       If using startx, modify '~/.xintirc' with the name of the new session.

          I.e.: gnome-session --choose-session=FVWM-Crystal-games

   Q 2.11: Why is there no application panel on the desktop?
       A: Do you have Python installed? Is 'fvwm-crystal.apps' script in a
       directory listed in $PATH environment variable? All files in Crystal's
       Application Database needs to have "executable" bit set (all files are
       actually scripts). You can set it by issuing command:

               chmod -R a+rx <installpath>/Applications

   Q 3.1: Where can I start some prefered application at startup?
       A: Copy the file /usr/share/fvwm-crystal/fvwm/preferences/Startup to
       and add yours commands here.

   Q 3.2: Where can I add my prefered fvwm command?
       A: You want to use some custom styles, keybindings or so. Create the
              ~/.fvwm-crystal/userconfig and add them here.

   Q 3.3: How can I have a tear off menu?
       A: When in the menu you want to tear off, press the backspace key. To
       remove the menu, press escape. This is a standard FVWM feature.

   Q 3.4: How can I record medias with mplayer?
       A: Recording with mplayer produce a stream dump. Such a dump is
       unusable for anything else than MPEG streams. When watching some MPEG
       source, press "c" and mplayer will begin to make a stream dump to the
       file "~/stream.dump". Press "c" again to stop capturing.

   Q 3.5: The Music menu get screwed. What can I do about this?
       A: According to Thomas Adam, auto-generated menus in FVWM are very
       sensitive to special characters. You must change all the special
       characters in the directories and folders names where FVWM will search
       for your media files. Take a look into FVWM-Crystal addons directory to
       know how you may process.

   Q 3.6: Mplayer doesn't show the movie I selected into FVWM-Crystal menu.
       A; You are watching something else. The file(s) was just added into
       mplayer's internal playlist. Press Enter or chosse Next in the menu.
       The DVB and DVD sources will play instantly.

   Q 3.7: Mplayer is flaky. What can I do?
       A: Try another video output. For that, edit "~/.mplayer/config" and put
       a line like "vo=xv" or "vo=gl".
           mplayer -vo help
       will show you a list.

       In the worst case (Fvwm-Crystal is unusable), go to one of the primary
       terminals with "Ctrl + Alt + F<n>", login and issue a
           killall -9 mplayer
       With "Ctrl + F7", you will go back to FVWM-Crystal.

       You can also try a different X graphic driver. For that, you must
       follow the documentation of your GNU/Linux distribution, install the
       wanted driver and edit the configuration of your X server.

version 3.1.7                   April 30, 2013               FVWMCrystalFAQ(1)