Gerard Braad's dotfiles using git, stow, and zsh

Note

Since I continously change how I work, so do these files and scripts. Do not use this directly, but take parts and learn from it.

Related side-projects

Actionfile

Machinefile

One-line install

curl -fsSL https://dotfiles.gbraad.nl/install.sh | sh

Note

This script uses the stable downstream to install.

Extensions for VS Code

Dotfiles checker - Marketplace, Open VSX Registry

Dotfiles tools - Marketplace, Open VSX Registry

Dot environment (.dotfiles without install)

{
 "terminal.integrated.defaultProfile.linux": "dot",
 "terminal.integrated.profiles.linux": {
 "dot": {
 // absolute path is necessary (no variables)
 "path": "/home/.../.dotfiles/bash/.local/bin/dot"
 },
 "dotscreen": {
 "path": "/home/.../.dotfiles/bash/.local/bin/dotscreen"
 }
 }
}

{
 "version": "2.0.0",
 "tasks": [
 {
 "label": "dot",
 "type": "shell",
 "problemMatcher": [],
 "command": "~/.dotfiles/bash/.local/bin/dot"
 //"command": "zsh" // when dot is used as default terminal
 },
 {
 "label": "dotscreen",
 "type": "shell",
 "problemMatcher": [],
 "command": "~/.dotfiles/bash/.local/bin/dotscreen"
 //"command": "screen"
 }
 ]
}

Note

Tasks are run in the default termina. If this is set to dot, any function that has been defined, can be run directly.

Feature for devcontainers

 "features": {
 "ghcr.io/gbraad-dotfiles/devcontainer-features/dotfiles:latest": {}
 }

Containers

Image-based Virtual Machines

$ machine dotfiles [download|create|start|console]

Manual process using virt-install

$ wget https://github.com/gbraad-dotfiles/upstream/releases/download/250223/almalinux-disk.qcow2 \
 -O base.qcow2
$ sudo virt-install \
 --name base --os-variant fedora-eln \
 --cpu host --vcpus 4 --memory 4096 \
 --import --disk ./base.qcow2,format=qcow2

Instant Developer Environments

Usage in Jupyter notebooks

%load_ext dotfiles

%%dotscript
country

> The Netherlands

%%dotscript
proxy ndisguise
country

> Germany

out=%dotini dotfiles file
%code out ini

out=%dot ps ax
%code out

%app list services
%app pinger service install
%app pinger service status

Note

To use the extension, stow ipython needs to be run. More information can be found in the dedicated gbraad-dotfiles/notebooks repository with examples.

GitHub Actions

GitHub Action: install-action

 - name: Install dotfiles action
 uses: gbraad-dotfiles/install-action@main

GitHub Action: dotfiles-action

 - name: Run dotfiles command
 uses: gbraad-dotfiles/dotfiles-action@main
 with:
 action: update

GitHub Action: devenv-action

 - name: Run devenv command
 uses: gbraad-dotfiles/devenv-action@main
 with:
 prefix: dotfedora
 command: exec # [create/system/noinit|start|apps|...]
 args: cat /etc/os-release

GitHub Action: devbox-action

 - name: Run devbox command
 uses: gbraad-dotfiles/devbox-action@main
 with:
 prefix: fedora
 command: exec # [create|start|apps|...]
 args: cat /etc/os-release

GitHub Action: machine-action

 - name: Run machine command
 uses: gbraad-dotfiles/machine-action@main
 with:
 prefix: dotfedora
 command: download # [create|start|stop|...]

GitHub Action: app-action

 - name: Run app install
 uses: gbraad-dotfiles/app-action@main
 with:
 appname: vivaldi
 action: install

GitHub Action: dot-action

 - name: Requiremnent for dot
 run: |
 sudo apt update
 sudo apt install -y zsh

 - name: Run dot command - devenv dotfedora exec cat /etc/os-release
 uses: gbraad-dotfiles/dot-action@main
 with:
 run: |
 devenv dotfedora exec cat /etc/os-release

Note

This runs the specified commands without the need to 'install' the dotfiles. It is required for the runner to have zsh installed.

Ansible

Ansible role: gbraad.dotfiles and playbooks

 - name: Install dotfiles
 hosts: localhost
 roles:
 - role: gbraad.dotfiles
 vars:
 user: gbraad

Ansible role: gbraad.dotfiles-devenv

 - name: Run devenv command
 hosts: localhost
 roles:
 - role: gbraad.dotfiles-devenv
 vars:
 prefix: gofedora
 command: start

Ansible role: gbraad.dotfiles-apps

 - name: Run app installs
 hosts: localhost
 roles:
 - role: gbraad.dotfiles-apps
 vars:
 appname: vivaldi
 action: install

Ansible role: gbraad.dotfiles-machine

 - name: Run Go build vm
 hosts: localhost
 roles:
 - role: gbraad.dotfiles-machine
 vars:
 prefix: gofedora
 command: start

Example/test: ⚙️

Build status of dotfiles Containers ⚙️ 🛠️ 🛠️

Fedora

CentOS

AlmaLinux

Others

Other build status

Container Registry Cleanup

Application defintions

Actionfiles

Notebooks

Downstream

Presentations

Compatibility

Author