Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Desktop environment based on Fvwm
Python Perl Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
artwork
bin
modules
templates
themes
Changelog
Changelog_installer
README
ToDo
config
install.sh

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.