README.md

My personal dotfiles

Table of Contents

• Introduction
• Getting started
  • Dependencies
  • Usage
  • Deploying
• Forks
  • Contents
• License
• Work in progress

Introduction

This repo contains my personal cfgs for my custom desktop environment. You are free to fork and customize it. Track your dot-stuff!

I'm Arch Linux user, a great part of software listed in dedependencies section is available in Arch oficial repos or AUR.

Cloned from github:

• polybar-scripts, I've got my own fork of this repo and I hope to contribute in a near future. My custom scripts are included in this repo.
  
  
  
  

Getting started

Dependencies

• i3wm - comminity
  • i3-gaps (i3wm's fork, so you must chose one of them, i3 or i3-gaps, see contents) - comminity
  • i3-gnome. Not mandatory but I strongly recommend it in order to manage things your cursor/icon themes, online accounts, etc. It does requires gnome as dependency, but I'm researching about how to integrate it with minimum gnome's packages required. It can be installed alongside i3 or i3-gaps - AUR
  • Perhaps a few more extra packages which I start in the i3 startup. Like Megasync client, but those are optional.
• rofi - comminity
  • rofi-calc - AUR
• polybar - AUR
  • polybar-scripts - GH, but a few of those scripts are included and customized in this repo.
• compton - community
  • No speciacial dependencies. Default cfg
• weechat - comminity
• zsh - extra
  • powerlevel10k - comminity
• Fonts
  • cantarell-fonts - extra
  • ttf-font-awesome - comminity
  • siji-git - AUR
  • nerd-fonts-complete - AUR
  • ttf-weather-icons - AUR
  • ttf-go-mono-git - AUR

Usage (Clone/Fork)

• You are free to fork/clone this repo for personal usage, they are simple config files.

• The main script is launcher-polybar, it is launching the following resources:

  • polybar
  • megasync
  • feh

  depending on the $HOSTNAME value

Deploying

The most important thing to mention in here is that, this is a conventional git repo, so you are free to clone it into your $HOME and then use stow to create the proper symlinks folder by folder, e.g.

$ cd ~/
$ git clone https://github.com/jfernandz/dotfiles/tree/desktop
$ cd ~/dotfiles
$ stow i3

It will symlink this i3 cfg folder into your $HOME/.config/i3 folder (preserving the folder structure).

---

Note: In the case you have already a cfg folder for i3 (that's to say, $HOME/.config/i3 already exist), then stow will warn you, and you will must to backup that already existing config if you want to use this one instead of yours.

---

Forks

You are free to fork this project, but since these are personal cfgs, I think I won't accept pull requests. Obviously you might want to fork it and customize. To get it clear, my workflow is like I've described in usage and the contents are described below.

Contents

In detail, this repo does contain my personal configs for my two personal computers. This repo only needs a branch to at the moment.

• master

  It does contain the general/shared cfg files, specifically config files for these programs

  • i3 / i3-gaps (i3-gaps is a fork of i3, so it you cannot install both at the same time. You must chose i3-gaps or disable inside i3 conf file the lines from 305 to 427)
  • compton
  • rofi + rofi-calc
  • termite
  • weechat scripts for weechats do not load apparently (despite of they are listed in the config file), anyway at this moment I'm using the following (you are able to use /script command in weechat to manage them):
    • go.py
    • highmon.pl
    • grep.py
    • unset_unused.pl
    • autosort.py
    • emoji.lua
  • zsh + zimfw + powerlevel9k
  • polybar + polybar-scripts
    
    
    
    

License

I think this could be an unlicensed repo. They only are setups.

Work in progress

At this time I'm working on it, so it may looks like a bit empty.