• 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