lang fr|gb

the awesome session

special feature: session configured by Aphelion :)

Awesome is a window manager using the principle of different tiling windows on the screen. that is to say that each window using the full remaining space and does not overlap with one another. Awesome is highly configurable and its configuration files are written in the Lua language. Awesome let you choose dynamically a layout on each workspace. Awesome is based on the code of DWM. its main features:

  • stable, fast and light
  • uses faster asynchronous XCB library instead of synchronous old Xlib
  • multi-head support (XRandR, Xinerama or Zaphod)
  • FreeDesktop standards implementation : EWMH, XDG Base Directory, XEmbed, System Tray
  • real transparency support (through Composite extension & xcompmgr)
  • dynamic window rearrangement on-the-fly. Popup windows are automatically floating or fixed
  • disposition : automatic window managment specific on each tag
  • Lua extensions

screenshots

startup

awesome is launched by the ~/bin/start/awesome_start.sh script.
to change your startup applications, simply ecdt this file: vim bin/start/awesome_start.sh or from the awesome menu:section preferences:awesome:edit srtartup script

components

awesome has been enriched with several libraries to display widgets, the menu client...

    • vicious: credits: Lucas de Vries, Adrian C. (anrxc).
    • couth: moc/mpd widget lib. credits: Bzed - http://awesome.naquadah.org/wiki/Calendar_widget & Marc Dequènes (Duck) - Duck@DuckCorp.org
    • shifty: dynamic tag managment. credits: koniu gkusnierz@gmail.com & resixian (aka bioe007) resixian@gmail.com http://awesome.naquadah.org/wiki/index.php?title=Shifty
    • toolbox: credits: Perry Hargrave
    • calendar2: credits: Adrian C. anrxc.sysphere.org http://sam.zoy.org/wtfpl/COPYING
    • client-menu: credits: Perry Hargrave
    • teardrop: crédits: Adrian C. anrxc.sysphere.org
i've also added a conky (from Aphelive).

awesome includes two statusbars (bottombar is hidden by default) displaying severals informations about your system and its utilisation:

  • topbar displays: menu, taglist, layout buttontasklist, wibox and systray.
  • bottombar, hidden by default (Ctrl+Alt+b to toggle hide), displays: network information, moc player infos & uptime.

configuration

to configure conky, simply edit its conkyrc: vim .conky/.conkyrc_awesome or from the awesome menu:section preferences:conky.

awesome configuration

awesome appearance is configured from the awesome menu:section preferences:awesome:themes. you can download awesome themes on the web and place it in /usr/share/awesome/themes so that awesome can use it.

usualy, awesome configuration is made by editing its main config file: ~/.config/awesome/rc.lua. but on livarp, Aphelion has divided this big file into various files and has created ~/.config/awesome/config.lua, fully commented, a magic file that let you configure awesome without understand LUA (like me)... thanks Aphelion :D

the magic file: config.lua:
this file cans configure the directories to use, the font, the wibox (widgets on statusbar), menu & help language ...

-- folders
wallpapers = "/usr/share/backgrounds"
screenshots = home .. "/tmp/"

-- mono font for widget popups (mandatory for popup to work)
monofont = "DroidSansMono 7"

--awesome menu
--if true the Awesome menu icon will show on top left corner
--menu still accessible with right clic and Alt+p
menu_icon = true
--support fr and en
menu_lang = "en"

--taglists
--type: support static/dynamic
taglist = "static" 
-- if static select taglists_type
-- options: awesome (a,w,e,s,o,m,e...), arabic (1,2,3...),
--          east_arabic (١, ٢, ٣,...), persian_arabic(٠,١,٢,٣,۴,....},
--          roman (I, II, III, IV,)
taglist_style = "awesome"

--clients
--enable clients titlebar
enable_titlebar = false
--enable clients titlebar only when client is floating
enable_floatbar = false
--enable client tasklist icons
tasklist_icon_enable = false

--wibox
--support text/graph
widget_mode = "graph"
--display icons: support true or false
-- if icons not in theme, default icons set will be used
show_icons = true 
-- display top_bar: support true/false
-- toggle with ctrl+alt+t
-- only work on primary screen
top_bar_visible = true   
-- display bottom_bar: support true/false
-- toggle with ctrl+alt+b
-- only work on primary screen
bottom_bar_visible = false
--invert widgets bar (top is bottom and bottom is top)
invert_bar = false
--wibox bar opacity (transparency between 0 and 1)
wibox_opacity = 0.85

--date widget
--en_EN.UTF-8 for english -- fr_FR.UTF-8 for french
date_lang = "fr_FR.UTF-8"
-- refer to http://en.wikipedia.org/wiki/Date_(Unix) specifiers
date_format = "%a %d %b %Y %R" 

--cpu widget
-- Show CPU info
cpu_enable = true
--Show CPU temp
cputemp_enable = false

--mem widget
-- Show memory bar
mem_enable = true
-- Show memtext --need mem to be enable too
memtext_enable = false
-- text format: $1 percentage, $2 used $3 total $4 free
memtext_format = " $2Mb Used"

--disk widget
--show boot partition bar
diskbootbar_enable = false
--show root partition bar
diskrootbar_enable = true
--show home partition bar
diskhomebar_enable = false

--system
-- show uptime and load
uptime_enable = true

--network widget
--show net traffic
net_enable = true
--show apt update if any
apt_enable = false
--show unread mail in gmail box
--(need ~/.netrc with -> 
-- machine mail.google.com login 'e-mail address' password 'password')
gmail_enable = false 
--show weather info
weather_enable = false
--if show weather is enable use this code
weather_code = "LFPO"

--volume widget
--enable volume widget
vol_enable = true

-- music widget
--show mpd widget (need mpd and mpc to be installed)
mpd_enable = false
--show moc widget
moc_enable = true

--bat widget
-- Show battery state
battery_enable = true

--info help icon
-- Show help on awesome wm shortcuts
infoicon_enable = true

--default icons if not in theme
default_cal_img = os.getenv("HOME").."/.config/awesome/icons/dzen/clock.png"
default_cpu_img = os.getenv("HOME").."/.config/awesome/icons/dzen/cpu.png"
default_mem_img = os.getenv("HOME").."/.config/awesome/icons/dzen/mem.png"
default_bat_img = os.getenv("HOME").."/.config/awesome/icons/dzen/bat_full_01.png"
default_fs_img = os.getenv("HOME").."/.config/awesome/icons/dzen/fs_01.png"
default_info_img = os.getenv("HOME").."/.config/awesome/icons/dzen/info_01.png"
default_vol_img = os.getenv("HOME").."/.config/awesome/icons/dzen/spkr_01.png"
default_music_img = os.getenv("HOME").."/.config/awesome/icons/dzen/note.png"
default_netup_img = os.getenv("HOME").."/.config/awesome/icons/dzen/net_up_01.png"
default_netdn_img = os.getenv("HOME").."/.config/awesome/icons/dzen/net_down_01.png"

keybinds/mousebinds

shortcuts are configured in ~/.config/awesome/config/keys.lua & prefferdapps.lua

keybinds available with the help-button on awesome top_bar.

menus:

  • awesome menu: menu icon on top_bar, Alt+p or right-click on desktop
  • dmenu: Alt+F2
  • prompt: Alt+r
  • search the web: Alt+F3

control:

  • reload awesome: Ctrl+Alt+r
  • quitt awesome: Ctrl+Alt+q ou depuis le menu awesome:exit
  • toggle hide topbar: Ctrl+Alt+t
  • toggle hide bottombar: Ctrl+Alt+b

clients:

  • close client: Alt+q
  • previous client: Alt+j
  • next client: Alt+k
  • last client: Alt+Tab
  • swap with the previous client: Ctrl+Alt+j
  • swap with the next client: Ctrl+Alt+k
  • toggle free the client: Ctrl+Alt+Space
  • move client: Alt+clic-gauche
  • resize client: Alt+clic-droit

navigation:

  • previous/next tag: Alt+Left/Right
  • swap with last tag: Alt+Esc
  • tag with previous/next tag: Alt(+Shift)+n
  • goto 'urgent' tag: Alt+u
  • add a tag: Alt+a
  • rename a tag: Alt+Shift+r
  • delete a tag: Alt+Shift+d

layout

  • increase master area: Alt+l
  • decrease master area: Alt+h
  • next layout: Alt+Space
  • previous layout: Alt+Shift+Space

launchers:

  • launch default terminal: Alt+Enter
  • launch prompt: Alt+r
  • launch ranger: Alt+f
  • launch rox-filer: Alt+Shift+f
  • launch luakit: Alt+w
  • launch firefox: Alt+Shift+w
  • launch weechat: Alt+i
  • music player: Alt+m
livarp_0.3.9 help center - arpinux@2012 - sources