██████   ██████  ████████ ███████
██   ██ ██    ██    ██    ██
██   ██ ██    ██    ██    ███████
██   ██ ██    ██    ██         ██
██████   ██████     ██    ███████

◎ Config files and utility scripts

Overview

This repository contains many common configuration files and development scripts I use daily. With a rich collection of Bash scripts, Python config files, and shell enhancements, this repo helps you:

• 🚀 Automate repetitive dev tasks
• 🛠️ Set up and manage environments fast
• 🎵 Download and convert YouTube playlists
• 📚 Aggregate docs for LLM workflows
• 🧹 Clean, lint, and test codebases with a single command
• ⚡ And much more!

Project Structure

The repository is structured as follows:

.
├── docker
│   └── build_and_publish.sh
├── docs
│   ├── common
│   │   └── python-project-templates.md
│   └── quickstart
│       └── uv.md
├── git
│   └── gitignore.txt
├── just
│   ├── justfile
│   └── python-justfile.md
├── lint
├── make
│   ├── Makefile
│   ├── Makefile.help.table
│   ├── Makefile.poetry.mk
│   └── Makefile.uv.mk
├── python
│   ├──  noxfile.py
│   ├── conf
│   │   ├── pyproject-poetry.toml
│   │   └── pyproject-uv.toml
│   ├── lint
│   ├── tests
│   │   ├── behave.ini
│   │   └── pytest.ini
│   └── type-checker
│       ├── mypy.ini
│       └── ty.toml
├── scripts
│   ├── builds
│   │   ├── docker_hub.sh
│   │   └── pypi.sh
│   ├── common
│   │   ├── clean.sh
│   │   ├── run.sh
│   │   └── test.sh
│   ├── converters
│   │   └── svg_to_png.sh
│   ├── cookie-cutter
│   │   └── create_structure.sh
│   ├── file
│   │   ├── aggregate_docs.sh
│   │   ├── chunk_docs.sh
│   │   └── modify_filenames.sh
│   ├── generators
│   │   └── mkdir_from_tree.sh
│   ├── install
│   │   ├── local_dependencies_uninstall.sh
│   │   ├── local_dependencies.sh
│   │   ├── micromamba.sh
│   │   ├── migrate_to_uv.sh
│   │   ├── precommit.sh
│   │   └── pyflink.sh
│   └── youtube
│       ├── download.log
│       ├── failed_links.txt
│       ├── README.md
│       ├── youtube_downloader.sh
│       └── youtube_links.txt
├── tmux
├── vscode
│   └── settings.json
└── zsh
    ├── .zprofile
    └── .zshrc

---

Installation

To get started with the utility scripts, build the project from source:

1. Clone the repository:

   ❯ git clone https://github.com/eli64s/dots

2. Navigate to the project directory:

   ❯ cd dots

Running Scripts

🔻 YouTube Batch Downloader

Batch download YouTube videos from csv file of URLs and convert them to MP3 files.

1. Make the script executable:

   ❯ chmod +x scripts/youtube/youtube_downloader.sh

2. Prepare a file with YouTube links (one URL per line):

   ❯ printf "https://youtu.be/dQw4w9WgXcQ\nhttps://youtu.be/3JZ_D3ELwOQ" > youtube_links.txt

3. Run the batch downloader:

   ❯ ./scripts/youtube/youtube_downloader.sh youtube_links.txt

Tip

The scripts directory contains a variety of utilities for automating tasks like environment setup, file operations, and codebase management.