Need help with notion?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

raboof
185 Stars 54 Forks GNU Lesser General Public License v2.1 3.9K Commits 85 Opened issues

Description

Tiling tabbed window manager

Services available

!
?

Need anything else?

Contributors list

# 14,714
playfra...
akka-ht...
alarm-c...
gRPC
2044 commits
# 391,925
Haskell
Lua
Shell
1200 commits
# 621,772
Shell
C
C++
132 commits
# 153,215
Shell
C++
C
elastic...
41 commits
# 323,993
Lua
sed
C
hammers...
41 commits
# 426,262
Shell
demosce...
shadert...
glsl
40 commits
# 174,057
Perl
Lua
Linux
Emacs
29 commits
# 603,411
C
Shell
C++
26 commits
# 27,889
blender
renderi...
b3d
Ada
21 commits
# 286,268
C++
C
Shell
gamepad
13 commits
# 708,872
Postgre...
mysqli
SQLite
C
7 commits
# 385,274
C++
C
Shell
6 commits
# 97,774
Zsh
Shell
C
C++
6 commits
# 82,869
Perl
rimworl...
game-fr...
elm
6 commits
# 49,912
Shell
Lua
HTML
web-bro...
6 commits
# 230,676
Vim
file-ma...
Shell
C
5 commits
# 57,139
bash-pr...
bash-ha...
Bash
Shell
5 commits
# 781,795
Common ...
Shell
C++
4 commits
# 48,809
nix
sed
PureScr...
gnome-s...
4 commits
# 230,052
http-ap...
pluggab...
Flask
swagger
4 commits

Notion

Build Status

Copyright (c) the Notion team 2010-2019. Copyright (c) Tuomo Valkonen 1999-2009.

https://notionwm.net

Building and installing

  1. Get the source code.
git clone https://github.com/raboof/notion
  1. In addition to the standard C library headers and the GNU toolchain, you will need the following tools and libraries for building Notion.
* Lua interpreter and header files, 5.1 or later 
* Xlib header files 
* libXext header files 
* libSM header files 
* gettext 

If you want to build the modxinerama and modxrandr module, which provide enhanced multihead support, you will further need the following libraries.

* Xinerama header files 
* XRandR header files 

If you want to enable support for Xft fonts, you need libxft:

* libxft 

On a Debian based system, these dependencies are provided by the following packages. build-essential lua5.1 liblua5.1-0-dev libx11-dev libxext-dev libsm-dev gettext libxinerama-dev libxrandr-dev libxft-dev

  1. If the default build settings don't suit you, review system-autodetect.mk and either override values from the environment or in a newly added system-local.mk or make changes directly to system-autodetect.mk.

  2. If you want to build some extra modules now or do not want to build some of the standard modules, edit

    modulelist.mk
    .
  3. Run

    make
    . Note that
    make
    here refers to GNU make which is usually named
    gmake
    on systems with some other implementation of make as default.
  4. Run

    make install
    , as root if you set
    $PREFIX
    in
    system.mk
    to a directory that requires those privileges.

YOU SHOULD NOT SKIP THIS STEP unless you know what you are doing. Notion will refuse to start if it can not find all the necessary uncorrupt configuration files either in

$PREFIX/etc/notion/
or in
~/.notion/
.
  1. How to best set up
    startx
    or whatever to start Notion instead of your current window manager depends on your system's setup. A good guess is creating or modifying an executable shell script
    .xsession
    in your home directory to start Notion. This should usually (but not always) work if you're using some X display/login manager. If
    ~/.xsession
    does not help and you're not using a display manager, modifying
    ~/.xinitrc
    or creating one based on your system's
    xinitrc
    (wherever that may be; use
    locate
    ) may be what you need to do. Note that unlike
    .xsession
    , a
    .xinitrc
    should usually do much more setup than simply start a few programs of your choice.

Some optional installation steps

  1. The F5 and F6 keys expect to find the program

    run-mailcap
    to select a program to view a file based on its guessed MIME type. Unless you are using Debian, most likely you don't have it, but any other similar program (or just plain old text editor) will do as well -- just modify the bindings in
    cfg_notioncore.lua
    . Of course, if you don't want to use the feature at this time or never, you may simply skip this step. If you want to use
    run-mailcap
    , it can be found from the following address, as a source tarball as well:

    http://www.debian.org/Packages/unstable/net/mime-support.html

  2. Notion supports caching known man-pages in a file for faster man-page completion in the F1 man page query. To enable this feature, you must periodically run a cronjob to build this list. To create a system-wide man page cache, run

    crontab -e
    (might vary depending on platform) as root and enter a line such as follows:
    15 05 * * * $SHAREDIR/ion-completeman -mksyscache
    

Replace

$SHAREDIR
with the setting from
system.mk
(or
system-ac.mk
if you used autoconf). This example runs daily at 05:15, but you may modify the run times to your needs; see the crontab manual.

If you can't or do not want to build a system-wide man page cache, run

crontab -e
as your normal user and replace
-mksyscache
with
-mkusercache
above. The cache file will be
~/.notion/mancache
.

It may also be useful to run

ion-completeman
with the suitable
-mk*cache
argument once manually to build the initial cache.

If the

MANPATH
environment variable is not set on your system and it does not have the
manpath
command (or it does not print anything sensible), you may also want to set the
ION_MANPATH
environment variable to the list of paths where the system stores manual pages.

Configuration

For help on modifying Notion's configuration files, PLEASE READ THE DOCUMENT "Configuring and extending Notion with Lua" available from the Notion web page, listed at the top of this file.

Questions, comments, problems?

If the available documentation does not answer your question, please join our IRC channel, #notion on freenode.

Contributing

Contributions to Notion are very welcome! Please join us on GitHub. The Notes for the module and patch writer might be helpful.

Credits

Notion was written by the Notion team, based on Ion which was written by Tuomo Valkonen.

The dock module was written by Tom Payne and Per Olofsson.

utils/ion-completefile/ion-completefile.c
is based on editline, (c) 1992 Simmule Turner and Rich Salz. See the file for details.

The code that

de/fontset.c
is based on was apparently originally written by Tomohiro Kubota; see http://www.debian.org/doc/manuals/intro-i18n/ch-examples.en.html#s13.4.5.

Various (minor) patches have been contributed by other individuals unlisted here. See the mailing list archives and the darcs source repository history (previously at http://iki.fi/tuomov/repos/). For translators see the individual

.po
files in
po/
.

See

libtu/README
for code by others integrated into libtu.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.