• Stars
    star
    173
  • Rank 220,124 (Top 5 %)
  • Language
    Lua
  • Created over 14 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

๐Ÿ“• Example awesome wm configuration. Includes personalization support (personal.vim), theme, polyglot unicode taglists, mpd support.

Version: Awesome 3.4.10 Awesome Homepage: http://awesome.naquadah.org

Beta testing: Awesome 3.5 is being tested in the v3.5 branch. It is experimental, if you have any problems feel free to file an issue.

NOTICE: version 3.5 is going to get the latest features. I will merge these branches when I am sure that 3.4 still works with them, but that will only happen seldomly. If you want to try out the latest features I've added (such as a lock screen command, monitor focus changes, etc.) please checkout the 3.5 branch

Based off of Adrian C's awesome config.

The aim of this project is to create a robust yet beautiful awesome configuration that works out of the box with minimal configuration.

Features

  • Modkey + Shift + Enter is Terminal
  • Modkey + Control + r is reload rc.lua
  • Modkey + t to attach/detach window from tiles
  • Modkey + shift + t to toggle titlebars
  • Battery widget - autodetects if you have battery, adds widget
  • Network widget - pick your devices, eth0 for ethernet, wlan0 for wireless or custom
  • Number taglists in various number systems - arabic (1,2,3...), chinese
  • mpd widget - autodetects if song player, adds widget (requires curl)
  • Random background picker (requires feh)

Credits

Installation

To use this configuration, git clone this, and mv awesome-config to ~/.config/awesome

  • cd ~/.config; git clone https://github.com/tony/awesome-config.git awesome
  • cd ~/.config/awesome
  • git submodule init && git submodule update - download vicious module

Try the one liner:

git clone https://github.com/tony/awesome-config.git ~/.config/awesome && cd ~/.config/awesome && git submodule init && git submodule update && less ~/.config/awesome/README.md

If you are using awesome version 3.5 (beta, in testing), then do:

  • cd ~/.config/awesome
  • git checkout v3.5

Version 3.5 is in testing in the 3.5 branch.

Configuration

Create a file called personal.lua in ~/.config/awesome. Here are some things you can place in your ~/.config/awesome/personal.lua file:

terminal = 'xterm' -- can be app in path, or full path e.g. /usr/bin/xterm
editor = "vim"

wallpaper_dir = os.getenv("HOME") .. "/yourwallpaper_dir/" -- grabs a random bg

taglist_numbers = "arabic" -- we support arabic (1,2,3...),
-- arabic, chinese, {east|persian}_arabic, roman, thai, random

cpugraph_enable = true -- show CPU graph
cputext_format = " $1%" -- %1 average cpu, %[2..] every other thread individually

membar_enable = true -- show memory bar
memtext_format = " $1%" -- %1 percentage, %2 used %3 total %4 free

date_format = "%a %m/%d/%Y %l:%M%p" -- refer to http://en.wikipedia.org/wiki/Date_(Unix) specifiers

networks = {'eth0', 'wlan0'} -- Add your devices network interface here netwidget, only show one that works

save.

You can use Mod + Control + r to reload configuation.

Autorun

Create a file called autorun.lua in ~/.config/awesome.

First is the binary of the app, the second is the arguments. So to load xscreensaver -no-splash we do: run_once("xscreensaver", "-no-splash").

run_once("xscreensaver", "-no-splash")         -- starts screensaver daemon 
run_once("xsetroot", "-cursor_name left_ptr")  -- sets the cursor icon

--run_once("redshift", "-o -l 0:0 -b 0.5 -t 6500:6500") -- brightness
run_once("ibus-daemon", "--xim") -- ibus
run_once(os.getenv("HOME") .. "/.dropbox-dist/dropboxd") -- dropbox
run_once("nm-applet") -- networking

run_once("wmname", "LG3D") -- java fix

run_once("sh " .. os.getenv("HOME") .. "/.screenlayout/dual-monitor.sh") -- set screens up

Optional stuff

Terminus is a crisp font pleasant to the eyes.

  • FreeBSD: cd /usr/ports/x11-fonts/terminus-font/ && make install clean or pkg_add -r terminus-font
  • ArchLinux: pacman -S terminus-font
  • Debian / Ubuntu: apt-get install xfonts-terminus
  • Gentoo: emerge -av media-fonts/terminus-font
  • Fedora / CentOS / Redhat: yum install terminus-fonts

In Arch, you may have to edit /etc/X11/xorg.conf and have your font dir to be scanned:

Section "Files"
	FontPath     "/usr/share/fonts/local"
EndSection

You may also want to:

  • cd /etc/fonts/conf.d
  • ln -sf ../conf.avail/10-autohint.conf ./
  • ln -sf ../conf.avail/70-yes-bitmaps.conf ./

Then restart X.

by Tony Narlock ([email protected])

Current maintainer:

Alex Keyes

More Repositories

1

tmux-config

๐Ÿ“— Example tmux configuration - screen + vim key-bindings, system stat, cpu load bar.
Shell
1,751
star
2

.dot-config

๐Ÿ“š Example dot configs for tmux, tmuxp, vim, vcspull, i3 and awesome
Nushell
123
star
3

NCURSES-Programming-HOWTO-examples

CMake examples for code in http://tldp.org/HOWTO/NCURSES-Programming-HOWTO/index.html
C
117
star
4

vim-config-framework

๐Ÿ“— VIM / Neovim configuration framework
Vim Script
98
star
5

cookiecutter-flask-pythonic

Pythonic starter boilerplate for Flask
Python
37
star
6

salt-states-configs

๐Ÿ“š states and formulas for saltstack (debian / ubuntu)
HTML
32
star
7

dot-fonts

Programmer and CJK / Unicode fonts.
Shell
28
star
8

tmuxp-config

Configs for tmuxp (https://github.com/tony/tmuxp)
Python
27
star
9

django-slugify-processor

custom slug / slugification rules for django https://devel.tech/tips/n/djms3tTe/how-django-uses-deferred-imports-to-scale
Python
15
star
10

steam-freebsd-client

based off steam linux client 1.0.0.51 - trying to get running on FreeBSD 11-CURRENT
Python
13
star
11

django-docutils

Docutils (a.k.a. reStructuredText, reST, RST) support for django
Python
12
star
12

cv

Tony Narlock's Resume (React vs Vue.js)
TypeScript
12
star
13

kohana-raven

kohana 3.2 module for raven, a client for the Sentry error reporting system.
PHP
8
star
14

sphinxcontrib-github

Use github repo and PR stats to sphinx projects
Python
8
star
15

tot-cpp-shmup

C++, CMake, SDL2 shooter minigame for The Tao of tmux and Terminal Tricks
C++
6
star
16

tot-go-webapp

Sample golang web application for The Tao of tmux and Terminal Tricks
Go
6
star
17

wxscintilla

wxscintilla updated for wxwidgets 3.0 and clang
C++
5
star
18

watching-testrunner

Command line tool for watching files and re-running shell commands.
Python
5
star
19

i3-config

Config for i3 window manager
Python
5
star
20

i3-gaps-freebsd

https://github.com/Airblader/i3 attempt at creating a config patch for adding gap support to i3
Makefile
5
star
21

xmonad-config

Ancient xmonad config (rc.lua, xmobarrc, xdefaults)
5
star
22

spectrwm-config

4
star
23

gpc

Mirror of QP Actor / HSM (Hierarchical State Machine) in C http://sourceforge.net/projects/qpc/
C
4
star
24

awesome-tmux-configs

Add your configs for tmux
3
star
25

scrotwm-config

Example scrotwm config file (.scrotwm.conf). Includes .conkyrc file for status bar. New config at https://github.com/tony/spectrwm-config
3
star
26

github-exercise

BROKEN (github revokes read-only api key to circumvent throttling) Backbone + Backbone.Marionette + Bootstrap + Gulp + requirejs example
JavaScript
3
star
27

ncurses-example

C
3
star
28

django-pure

A pythonic django 1.8 boilerplate, sans cruft, gracefully degrades to sqlite.
Python
2
star
29

screen-config

Example screen config (.screenrc). Features stats and loadbar.
2
star
30

sqlamp

sqlamp is an implementation of an efficient algorithm for working with hierarchical data structures โ€” Materialized Path. sqlamp uses (and depends of) SQLAlchemy. https://github.com/sontek/sqlalchemy_traversal http://sqlamp.angri.ru/ https://github.com/monetizeio/sqlalchemy-orm-tree http://docs.sqlalchemy.org/en/rel_0_9/orm/relationships.html#adjacency-list-relationships https://bitbucket.org/angri/sqlamp
Python
2
star
31

bootstrap_env

POSIX sh Wrapper and adapter for bootstrapping + sourcing virtualenv, virtualenvwrapper, pyenv-virtualenv and pyenv-virtualenvwrapper projects
Shell
1
star
32

react-typescript-vanilla-starter

React + Typescript (including typed webpack v4 config) + Babel
TypeScript
1
star
33

vcsync

https://github.com/tony/vcspull in golang
Go
1
star
34

setup-python-poetry-version-example

Example of poetry + cache issue with setup-python v3.1
Python
1
star
35

iOS-TipCalculator

iOS 5.1 Example App - A tip calculator
Objective-C
1
star
36

sdl2-playproject

playing around with c/c++, cmake and sdl2
C++
1
star
37

libunwind

Including OS X fork https://opensource.apple.com/tarballs/libunwind/ / http://opensource.apple.com/source/libunwind/
C
1
star