AwesomeFiles/.github/README.md

100 lines
3 KiB
Markdown
Raw Normal View History

2022-02-21 13:31:54 -06:00
<!-- Screenshot -->
<div align="center">
<img src="https://awesomewm.org/images/awesome-logo.svg">
</div>
<br>
<div align="center">
<img src="assets/awesome.png">
</div>
<br>
<br>
<!-- SETUP -->
<a href="https://awesomewm.org/"><img alt="AwesomeWM Logo" height="160" align = "left" src="https://awesomewm.org/doc/api/images/AUTOGEN_wibox_logo_logo_and_name.svg"></a>
<b> ~ AwesomeWM dotfiles ~ </b>
Welcome to my AwesomeWM Dotfiles! so yeah now i'm using awesomewm, looks like i'll be use this wm forever.
Still quite messy, because i'm still learning Lua.
Fyi, I use night colorscheme, and it's so beautiful.
### Here are the instructions you should follow to replicate my AwesomeWM setup.
<details open>
<summary><strong>S E T U P</strong></summary>
1. Install dependencies and enable services
+ Dependencies
- **Arch Linux** (and all Arch-based distributions)
*Assuming your AUR helper is* `yay`
```shell
$ yay -S awesome-git picom-ibhagwan-git alacritty rofi \
acpi acpid acpi_call xfce4-power-manager inotify-tools \
jq redshift mpd mpdris2-git mpc ncmpcpp polkit-gnome \
brightnessctl alsa-utils pulseaudio pulseaudio-alsa playerctl-git \
lua lua53 luarocks todo-bin
```
+ Services
```shell
# For automatically launching mpd on login
$ systemctl --user enable mpd.service
$ systemctl --user start mpd.service
# For charger plug/unplug events (if you have a battery)
$ sudo systemctl enable acpid.service
$ sudo systemctl start acpid.service
```
3. Install needed fonts
You will need to install a few fonts (mainly icon fonts) in order for text and icons to be rendered properly.
Necessary fonts:
+ **Iosevka** - [here](https://github.com/be5invis/Iosevka)
+ **Icomoon** - [here](https://www.dropbox.com/s/hrkub2yo9iapljz/icomoon.zip?dl=0)
+ **Material** - [here](https://github.com/google/material-design-icons)
Once you download them and unpack them, place them into `~/.fonts` or `~/.local/share/fonts`.
4. Install my AwesomeWM configuration files
> Clone this repository
```shell
$ git clone --recurse-submodules https://github.com/rxyhn/AwesomeWM-Dotfiles.git
$ cd AwesomeWM-Dotfiles
```
> Copy config and binaries files
```shell
$ mkdir -p $HOME/.config/ && cp -r ./config/* $HOME/.config/
$ mkdir -p $HOME/.local/bin/ && cp -r ./bin/* $HOME/.local/bin/
$ cp -r ./misc/* $HOME/
```
</details>
<br>
## Acknowledgements.
- Contributors
+ **[ner0z](https://github.com/ner0z)** for the aesthetic dashboard and some widgets.
- Thanks to
+ [JavaCafe01's Dotfiles](https://github.com/JavaCafe01/dotfiles)
<br>
<br>
<p align="center"><a href="https://github.com/rxyhn/AwesomeWM-Dotfiles/blob/main/.github/LICENSE"><img src="https://img.shields.io/static/v1.svg?style=flat-square&label=License&message=GPL-3.0&logoColor=eceff4&logo=github&colorA=061115&colorB=67AFC1"/></a></p>