Skip to content
This repository

Desktop environment based on Fvwm

tag: 0.4

Fetching latest commit…

Cannot retrieve the latest commit at this time

README
               _____________________________                        
              / ___________________________/ 
             / /_   ___      ______ ___
            / __/| / / | /| / / __ `__ \   ___
           / / | |/ /| |/ |/ / / / / / /  /__/
          /_/  |___/ |__/|__/_/ /_/ /_/ 
  
         _   ___        __    __       __              __    
        / | / (_)____ _/ /_  / /______/ /_  ____ _____/ /___ 
       /  |/ / // __ `/ __ \/ __/ ___/ __ \/ __ `/ __  // _ \
      / /|  / // /_/ / / / / /_(__  ) / / / /_/ / /_/ //  __/
     /_/ |_/_/ \__, /_/ /_/\__/____/_/ /_/\__,_/\__,_/ \___/ 
               /____/                                         
 

Welcome to Fvwm Nightshade! This project aims to be a lightweight but
feature rich and good looking configuration of Fvwm. It contains many 
useful things to make work and life easier with a flavour of a modern 
desktop. But it can be configure by your own. It is good documented and
shows you what is possible with this powerful window manager.


Featurelist of Fvwm Nightshade:
===============================
- 4 virtual desktop pages (at the moment)
- Taskbar to show running apps per page
- Systray (if stalonetray is installed)
- date and time (if xclock is installed)
- Lock desk & screensaver (if xscreensaver is installed)
- Personal menu via FvwmScript-PersonalMenu
- Background configurable with thumb browser (if imagemagick and eterm 
  is installed)
- Animation control of window moves
- Simple "Run" command with FvwmForm
- Some themes/decors (Default, Ambience and Air). Can be changed on the
  fly without restart
- Autostart possibility (starting apps while startup)
- Session management (in preperation)
- A useful set of GUI tools to configure the global system (Gtk+, Qt, 
  mouse, keyboard, etc)
- Help messages for mouse bindings in titlebar, window, corners, sides 
  and icon with Shift-Alt-Ctrl + click
- Help messages for key bindings with Shift-Alt-Ctrl + key (see on 
  "Keybindings")
  - A global one with Shift-Alt-Ctrl + H
- Dynamic menus
- Switching focus between windows with Alt-Tab
- Splash screen
- Print messages for needed apps for full config functionality in 
  .xsessions-error


Requirements:
=============
Required:	Fvwm >= 2.6.6, python-xdg, xterm, xclock, xscreensaver,
		eterm, imagemagick, stalonetray, wm-icons

Recommended: 	gnomes network manager, Volume Icon

Useful:		fdpowermon, bluetooth-applet, pm-utils, LxApearance, 
		qtconfig-qt3, qtconfig-qt4, xneurs
  

These systray apps started automatically, if stalonetray is installed:
----------------------------------------------------------------------
- Volume Icon: lightweight volume control 
  (http://softwarebakery.com/maato/volumeicon.html)
- fdpowermon: simple battery power monitor 
  (http://packages-holter.debian.org/de/wheezy/fdpowermon)
- nm-applet: gnomes network manager (http://projects.gnome.org/NetworkManager/)
- bluetooth-applet: gnomes bluetooth applet 
  (http://library.gnome.org/users/gnome-bluetooth/stable/gnome-bluetooth-applet.html.en)

Btw. it doesn't matter if they not installed. Will skip then ;-)


Keybindings:
============

Alt+Tab                           Switching focus between windows
Alt+Print                         Screenshot of the whole desktop (page)

Shift-Alt+F1                      Open root menu
Shift-Alt+F2                      Launch 'run' dialog box
Shift-Alt+F3                      Show window list
Shift-Alt+F4                      Close active window
Shift-Alt+F5                      Not used
Shift-Alt+F6                      Cycle between same resource windows
Shift-Alt+F7                      Move active window
Shift-Alt+F8                      Resize active window
Shift-Alt+F9                      Minimize active window
Shift-Alt+F10                     Maximize/restore active window
Shift-Alt+F11                     Maximize active window to fullscreen and back
Shift-Alt+F12                     Identify active window

-> Help message with Shift-Alt-Ctrl + A


Shift-Ctrl+F1                     Open full windows oops menu
Shift-Ctrl+F2                     Launch FvwmConsole

Shift-Ctrl+D                      Hide/unhide all windows
Shift-Ctrl+L                      Lock Screen
Shift-Ctrl+T                      Launch Terminal
Shift-Ctrl+Print                  Screenshot of the active window

-> Help message with Shift-Alt-Ctrl + C


Shift-Alt+1			  Switch to page 1 with active window
Shift-Alt+2			  Switch to page 2 with active window
Shift-Alt+3			  Switch to page 3 with active window
Shift-Alt+4			  Switch to page 4 with active window

Shift-Alt+Cursor right            Switch to page right with active window
Shift-Alt+Cursor left             Switch to page left with active window

Shift-Ctrl+1			  Switch to page 1
Shift-Ctrl+2			  Switch to page 2
Shift-Ctrl+3			  Switch to page 3
Shift-Ctrl+4			  Switch to page 4

Shift-Ctrl+cursor right           Switch to page right
Shift-Ctrl+cursor left            Switch to page left

Shift-Alt-Ctrl+cursor right       Scroll right by 10% of a page
Shift-Alt-Ctrl+cursor left        Scroll left by 10% of a page

Ctrl-Alt+cursor right             Move mouse pointer right by 1% of a page
Ctrl-Alt+cursor left              Move mouse pointer left by 1% of a page
Ctrl-Alt+cursor up                Move mouse pointer up by 1% of a page
Ctrl-Alt+cursor down              Move mouse pointer down by 1% of a page

-> Help message with Shift-Alt-Ctrl + P


Mouse bindings:
===============

Mouse:
  +------------+
  | ||  ||  || |
  |	       |
  +------------+
    1   2   3

Window:
  +----------------------------------------------------------+
  | V                                                -  +  X |
  +----------------------------------------------------------+
  |                                                          |


Left (V):
---------
Button 1: shows MenuWindowOpsTrimmed menu
Button 2: shows Move to page menu
Button 3: shows WindowOps group menu

Close (X):
----------
Every button close window

Maximize (+):
-------------
Button 1: maximize window
Button 2: maximize window vertically
Button 3: maximize window horizontally

Minimize (-):
-------------
Button 1: iconify window
Button 2: iconify group of same window resources
Button 3: iconify/deiconify group of same window resources

Mouse on windows decoration:
----------------------------
Titlebar, corners and sides:
Button 1:   Drag moves window, maximize on double click
Button 2:   Drag moves window, raise or lower with click
Button 3:   WindowOpsTrimmed menu with click, MenuWindowOpsFull menu 
	    with ALT + click
Button 4/5: Rolling wheel on titlebar up/down shades/unshades

Mouse on window area:
---------------------
Button 1:   Root menu with ALT + click
Button 2:   Drag + ALT moves window, raise or lower with ALT + click

Mouse on Icons (iconified):
---------------------------
Button 1:   Drag moves icon, deiconify with double click, root menu with 
            ALT + click
Button 2:   Deiconify icon with click, all of the same resource group 
	    with CTRL + click
Button 3:   WindowOpsTrimmed menu with click
	    WindowGroupOps menu with CTRL + click

Mouse on Root area:
-------------------
Button 1:   Root menu
Button 2:   Window list
Button 3:   Desktop menu

Anywhere:
---------
Button 4/5: Switch to page left/right with SHIFT-ALT + rolling wheel 
            up/down anywhere
Button 4/5: Switch with active window to page left/right with SHIFT-CTRL
            + rolling wheel up/down anywhere

Installation
============
Use the install.sh found in the root path of the Fvwm-Nightshade package


Bugs and Feature requests
=========================
Fvwm-Nightshade is young project. Bugs are possible. We try to avoid 
them but nobody is perfect ... So, if you find one or have ideas, submit
them under https://github.com/ThomasFunk/Fvwm-Nightshade/issues


Enjoy our work and hopefully you love Fvwm-Nightshade as we do ;-)


Team
====
Thomas Funk <t.funk@web.de>
Bernhard Popp <kermit.popp@googlemail.com>
Something went wrong with that request. Please try again.