Difference between revisions of "Bluetile"

From ArchWiki
Jump to: navigation, search
m (Bluetile Resources)
m (Style fixes)
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Tiling WMs (English)]]
+
[[Category:Tiling WMs]]
 +
Bluetile is a tiling window manager designed to integrate with the [[GNOME]] [[Desktop Environment|desktop environment]]. Why choose Bluetile? Because none of the other tiling [[Window Manager|window managers]] were built with the thought in mind that time is the most limited resource among the majority of users. It is good if you can configure a software in every respect. It is better if you do not have to.
  
Bluetile is a tiling window manager designed to integrate with the GNOME desktop environment.
+
The Bluetile project is really just another [[xmonad]] configuration. A configuration that focuses on making the tiling paradigm easily accessible to users coming from traditional window managers.  
 
+
== About ==
+
 
+
Why choose Bluetile? Because none of the other tiling window managers where built with the thought in mind, that time is the most limited resource among the majority of users. It's good if you can configure a software in every respect. It's better if you don't have to.
+
 
+
The Bluetile project is really just another xmonad configuration. A configuration that focuses on making the tiling paradigm easily accessible to users coming from traditional window managers.  
+
  
 
You can create pretty much the same effect with a standard xmonad installation, but this project exists to provide an easy installation path with zero configuration and without having to read (as much) background information.
 
You can create pretty much the same effect with a standard xmonad installation, but this project exists to provide an easy installation path with zero configuration and without having to read (as much) background information.
  
==Installation==
+
== Installation ==
  
1. sudo pacman -S ghc cabal-install gtk2hs-buildtools xmonad-contrib
+
1. [[pacman|Install]] the following packages from the [[official repositories]]: {{Pkg|ghc}} {{Pkg|cabal-install}} {{Pkg|gtk2hs-buildtools}} {{Pkg|xmonad-contrib}}.
  
2. cabal update
+
2. Update cabal:
 +
# cabal update
  
3. cabal install bluetile (See BUGS section if you get any compile errors)
+
3. Install bluetile:
 +
# cabal install bluetile
  
==Running Bluetile==
+
{{Note|See [[#Known issues|Known issues]] section if you get any compile errors.}}
  
After you have installed bluetile, to try it out simply:
+
== Running Bluetile ==
  
  cd ~/.cabal/bin  
+
After you have installed Bluetile, test it:
./bluetile
+
  $ ~/.cabal/bin/bluetile
  
===At Startup===
+
=== At start-up ===
  
If you wish to have bluetile launch automomatically after login:
+
If you wish to have bluetile launch automatically after logging in, you must set the correct PATH evironment label and then add ''bluetile'' to your start-up applications.
  
First add '''~/.cabal/bin''' to your PATH environment variable,
+
1. Edit {{ic|~/.bashrc}} and add the following line to the end:
 
+
then add the '''bluetile''' executable to your start up applications.
+
 
+
Follow this procedure,
+
 
+
1. Add this line at the end of your ~/.bashrc file:  
+
+
 
  export PATH=~/.cabal/bin:$PATH
 
  export PATH=~/.cabal/bin:$PATH
  
2. Next launch the program named '''gnome-session-properties''' from the command line, <br>
+
2. Next launch {{ic|gnome-session-properties}}:
or navigate to it through the GNOME Menu: '''Menu -> System -> Prefrences -> Startup Applications'''
+
$ gnome-session-properties
  
3. Click '''Add''' then type '''bluetile''' in the "command" field, the "name" and "comment" fields can contain whatever you like.
+
3. You will be presented with a list of your start-up applcations.
 +
Click: "Add"
 +
In the name field enter: Bluetile Window Manager
 +
In the command field enter: bluetile
 +
The comment field is optional.
  
 
Thats it, happy tiling!
 
Thats it, happy tiling!
  
==== More simple approach ====
+
=== Another approach ===
 
+
There is also the possiblity to set the WINDOW_MANAGER variable in the file '''~/.gnomerc'''. Simply add this line.
+
  
 +
You can also edit {{ic|~/.gnomerc}} and set the {{ic|WINDOW_MANAGER}} variable with:
 
  export WINDOW_MANAGER=/home/user/.cabal/bin/bluetile
 
  export WINDOW_MANAGER=/home/user/.cabal/bin/bluetile
  
With this Gnome will automatically use Bluetile instead of Metacity.
+
With this, [[GNOME]] will automatically use Bluetile instead of Metacity.
 +
{{Note|With this method there is no need to add bluetile to your {{ic|gnome-session-properties}}.}}
  
==BUGS==  
+
== Known issues ==  
  
===X11-1.4.6.1===
+
=== X11-1.4.6.1 ===
  
 
If you see an error that looks like this:
 
If you see an error that looks like this:
Line 68: Line 62:
 
   
 
   
 
Follow this procedure to fix this problem:
 
Follow this procedure to fix this problem:
 +
{{bc|
 +
# pacman -S libticonv
 +
$ cd ~/.cabal/packages/hackage.haskell.org/X11/1.4.6.1/
 +
$ tar xzf X11-1.4.6.1.tar.gz && cd X11-1.4.6.1/Graphics/X11/Xlib
 +
$ <Extras.hsc iconv -f ISO-8859-1 -t UTF8 >fix
 +
$ mv fix Extras.hsc
 +
$ cd ../../../
 +
# cabal install
 +
}}
  
1. sudo pacman -S libticonv
+
Once that is finished:
 
+
# cabal install bluetile
2. cd ~/.cabal/packages/hackage.haskell.org/X11/1.4.6.1/
+
 
+
3. tar xzf X11-1.4.6.1.tar.gz && cd X11-1.4.6.1/Graphics/X11/Xlib
+
 
+
4. <Extras.hsc iconv -f ISO-8859-1 -t UTF8 >fix
+
 
+
5. mv fix Extras.hsc
+
 
+
6. cd ../../../
+
 
+
7. cabal install
+
 
+
Once that is finished try '''cabal install bluetile''' again.
+
  
==Bluetile Resources==
+
== See also ==
  
'''Homepage:''' http://bluetile.org/
+
http://bluetile.org/ - Project home page
  
'''Wiki:''' http://www.haskell.org/haskellwiki/Bluetile
+
http://www.haskell.org/haskellwiki/Bluetile - Wiki

Revision as of 20:43, 5 September 2013

Bluetile is a tiling window manager designed to integrate with the GNOME desktop environment. Why choose Bluetile? Because none of the other tiling window managers were built with the thought in mind that time is the most limited resource among the majority of users. It is good if you can configure a software in every respect. It is better if you do not have to.

The Bluetile project is really just another xmonad configuration. A configuration that focuses on making the tiling paradigm easily accessible to users coming from traditional window managers.

You can create pretty much the same effect with a standard xmonad installation, but this project exists to provide an easy installation path with zero configuration and without having to read (as much) background information.

Installation

1. Install the following packages from the official repositories: ghc cabal-install gtk2hs-buildtools xmonad-contrib.

2. Update cabal:

# cabal update

3. Install bluetile:

# cabal install bluetile
Note: See Known issues section if you get any compile errors.

Running Bluetile

After you have installed Bluetile, test it:

$ ~/.cabal/bin/bluetile

At start-up

If you wish to have bluetile launch automatically after logging in, you must set the correct PATH evironment label and then add bluetile to your start-up applications.

1. Edit ~/.bashrc and add the following line to the end:

export PATH=~/.cabal/bin:$PATH

2. Next launch gnome-session-properties:

$ gnome-session-properties

3. You will be presented with a list of your start-up applcations.

Click: "Add"
In the name field enter: Bluetile Window Manager
In the command field enter: bluetile
The comment field is optional.

Thats it, happy tiling!

Another approach

You can also edit ~/.gnomerc and set the WINDOW_MANAGER variable with:

export WINDOW_MANAGER=/home/user/.cabal/bin/bluetile

With this, GNOME will automatically use Bluetile instead of Metacity.

Note: With this method there is no need to add bluetile to your gnome-session-properties.

Known issues

X11-1.4.6.1

If you see an error that looks like this:

hsc2hs: Graphics/X11/Xlib/Extras.hsc: hGetContents: invalid argument (Invalid 
or incomplete multibyte or wide character) 
cabal: Error: some packages failed to install: 
X11-1.4.6.1 failed during the building phase. The exception was: 
ExitFailure 1 

Follow this procedure to fix this problem:

# pacman -S libticonv
$ cd ~/.cabal/packages/hackage.haskell.org/X11/1.4.6.1/
$ tar xzf X11-1.4.6.1.tar.gz && cd X11-1.4.6.1/Graphics/X11/Xlib
$ <Extras.hsc iconv -f ISO-8859-1 -t UTF8 >fix
$ mv fix Extras.hsc
$ cd ../../../
# cabal install

Once that is finished:

# cabal install bluetile

See also

http://bluetile.org/ - Project home page

http://www.haskell.org/haskellwiki/Bluetile - Wiki