{"id":23960812,"url":"https://github.com/anstapol/dotfiles","last_synced_at":"2026-05-08T19:31:44.783Z","repository":{"id":270326176,"uuid":"863911814","full_name":"anstapol/dotfiles","owner":"anstapol","description":"One script to fully working dev environment 🚀","archived":false,"fork":false,"pushed_at":"2026-03-23T13:14:31.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-24T10:54:54.925Z","etag":null,"topics":["dotfiles","starship","unix","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anstapol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-27T06:32:22.000Z","updated_at":"2026-03-23T13:14:35.000Z","dependencies_parsed_at":"2024-12-30T10:34:49.837Z","dependency_job_id":"2d7be1e8-c4b1-4db4-96f0-cce385c2877c","html_url":"https://github.com/anstapol/dotfiles","commit_stats":null,"previous_names":["anstapol/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/anstapol/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anstapol%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anstapol%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anstapol%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anstapol%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anstapol","download_url":"https://codeload.github.com/anstapol/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anstapol%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32794576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dotfiles","starship","unix","zsh"],"created_at":"2025-01-06T19:55:00.619Z","updated_at":"2026-05-08T19:31:44.777Z","avatar_url":"https://github.com/anstapol.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# macOS Setup Automation\n\nThis repository contains a script to automate the setup and configuration of macOS. It installs essential software, configures system settings, and applies customizations for Dock, Finder, and Hot Corners.\n\n## Prerequisites\n\n- **Homebrew** must be installed (if not, the script will handle the installation).\n\n## Installation\n\n1. **Clone the repository**:\n\n   ```bash\n   git clone https://github.com/anstapol/dotfiles.git\n   cd dotfiles\n   ```\n\n2. **Run the setup script**:\n\n   ```bash\n   ./setup.sh\n   ```\n\n3. **Restart macOS** to ensure all settings are applied correctly.\n\n## What This Does\n\n- **Installs Homebrew packages** from the `Brewfile`, including:\n  - Formulae (command-line tools, libraries).\n  - Casks (GUI applications).\n  - App Store apps via `mas`.\n- **Configures macOS** settings such as:\n  - Dock autohide, magnification, and hot corners.\n  - Finder settings, including sidebar \u0026 view style.\n  - Automatically removes old Trash items after 30 days.\n\n### Dotfiles (GNU Stow)\n\nDotfiles are managed with [GNU Stow](https://www.gnu.org/software/stow/). All config files live in the `home/` package directory, mirroring the home directory structure. Running `stow -t $HOME home` creates symlinks for:\n\n- `~/.zshrc`\n- `~/.zsh_plugins.txt`\n- `~/.zsh_functions`\n- `~/.config/starship.toml`\n- `~/.config/ghostty`\n\nTo add a new config, place it in `home/` at the same relative path it would have in `~`, then re-run `stow -t $HOME home`.\n\n## Customizations\n\n### Starship Prompt\n\nThe Starship prompt is customized to provide a clean and informative right-aligned prompt. The prompt displays the following information:\n\n- **Directory**: Abbreviated fish-style path with distinct styling for repo root vs parent directories.\n- **Git Status**: Shows the status of the current Git repository, including stashed, staged, modified, deleted, renamed, untracked, and conflicted files.\n- **Git Branch**: Displays the current Git branch.\n- **Node.js Version**: Shows the current Node.js version.\n- **Command Duration**: Displays the execution time of the last command.\n\n### `tinify` function\n\nA `tinify` shell function is available for image compression using `ffmpeg`. This function can process single images or a batch of images in the current directory.\n\n**Usage**: `tinify [options] \u003cimage(s)\u003e`\n\n**Options**:\n- `-q, --quality \u003c1-100\u003e`: Quality level (default: 85)\n- `-o, --output \u003cfile\u003e`: Output filename\n- `-b, --batch`: Process all images in current directory\n- `-v, --verbose`: Show detailed output\n- `-h, --help`: Show this help\n\n## macOS Settings Applied\n\n### Dock Customizations:\n\n- **Autohide**: Enabling hiding the dock automatically \u0026 increasing the animation speeds.\n- **Magnification**: Magnify Dock icons when hovering over them \u0026 setting the exact size.\n- **Minimization**: Use the \"scale\" effect \u0026 minimized into application icon.\n- **Recent Applications**: Hides the recent applications section in the Dock.\n\n### Finder Customizations:\n\n- Hide External Hard Drives, Internal Hard Drives, and Removable Media on Desktop.\n- Enable Finder Sidebar, Path Bar, and Status Bar.\n- Set Default Finder View to List View.\n- Arrange Finder Items by Name.\n- Automatically Remove Old Trash Items after 30 days.\n\n### Hot Corners Customizations:\n\n- **Bottom-Left**: Starts the screen saver (requires Command ⌘ key).\n- **Bottom-Right**: Opens a Quick Note (requires Command ⌘ key).\n- **Top-Left**: Locks the screen (requires Command ⌘ key).\n- **Top-Right**: Opens the Notification Center (requires Command ⌘ key).\n\n## Installed Software\n\n### Homebrew Formulae:\n\n- **[antidote](https://getantidote.github.io/)**: A fast and lightweight plugin manager for Zsh.\n- **[awscli](https://aws.amazon.com/cli/)**: A unified tool to manage AWS services from the command line.\n- **[bash](https://www.gnu.org/software/bash/)**: The GNU Bourne Again SHell.\n- **[btop](https://github.com/aristocratos/btop)**: A resource monitor that shows usage and stats for processor, memory, disks, network, and processes.\n- **[cocoapods](https://cocoapods.org/)**: A dependency manager for Swift and Objective-C Cocoa projects.\n- **[colima](https://github.com/abiosoft/colima)**: Container runtimes on macOS with minimal setup.\n- **[docker](https://www.docker.com/)**: A platform for developing, shipping, and running applications in containers.\n- **[docker-buildx](https://docs.docker.com/buildx/working-with-buildx/)**: Docker CLI plugin for extended build capabilities with BuildKit.\n- **[docker-compose](https://docs.docker.com/compose/)**: Define and run multi-container applications with Docker.\n- **[doctl](https://github.com/digitalocean/doctl)**: The official command line interface for DigitalOcean.\n- **[fastfetch](https://github.com/fastfetch-cli/fastfetch)**: A neofetch-like tool for fetching system information and displaying them in a pretty way.\n- **[ffmpeg](https://ffmpeg.org/)**: A complete, cross-platform solution to record, convert and stream audio and video.\n- **[fnm](https://github.com/Schniz/fnm)**: Fast Node Manager - A fast and simple Node.js version manager, built in Rust.\n- **[fzf](https://github.com/junegunn/fzf)**: A command-line fuzzy finder.\n- **[gemini-cli](https://github.com/GoogleCloudPlatform/gemini-cli)**: CLI for Google Gemini.\n- **[gh](https://cli.github.com/)**: GitHub’s official command line tool.\n- **[git](https://git-scm.com/)**: A free and open source distributed version control system.\n- **[gnupg](https://gnupg.org/)**: A complete and free implementation of the OpenPGP standard.\n- **[gum](https://github.com/charmbracelet/gum)**: A tool for glamorous shell scripts.\n- **[jq](https://stedolan.github.io/jq/)**: Command-line JSON processor.\n- **[kubernetes-cli](https://kubernetes.io/docs/reference/kubectl/overview/)**: A command-line tool for interacting with Kubernetes clusters.\n- **[lcdf-typetools](https://www.lcdf.org/type/)**: Tools for manipulating OpenType and PostScript fonts.\n- **[mas](https://github.com/mas-cli/mas)**: A command-line interface for the Mac App Store.\n- **[mole](https://github.com/tw93/Mole)**: Deep clean and optimize your Mac.\n- **[neovim](https://neovim.io/)**: A hyperextensible Vim-based text editor.\n- **[opencode](https://github.com/nicepkg/opencode)**: An open-source AI coding assistant for the terminal.\n- **[rename](https://plasmasturm.org/code/rename/)**: Perl-powered file rename script.\n- **[starship](https://starship.rs/)**: The minimal, blazing-fast, and infinitely customizable prompt for any shell!\n- **[stern](https://github.com/stern/stern)**: Tail multiple Kubernetes pods and containers in real time.\n- **[stow](https://www.gnu.org/software/stow/)**: GNU Stow - a symlink farm manager for dotfiles.\n- **[stripe-cli](https://stripe.com/docs/stripe-cli)**: A command-line tool for Stripe that helps you build, test, and manage your Stripe integration.\n- **[supabase](https://supabase.com/docs/guides/cli)**: Supabase CLI for local development and management.\n- **[tree](https://mama.indstate.edu/users/ice/tree/)**: Display directories as trees.\n- **[vercel-cli](https://vercel.com/docs/cli)**: A command-line interface for Vercel that helps you develop and deploy your projects.\n- **[watchman](https://facebook.github.io/watchman/)**: A tool by Facebook for watching changes in the filesystem and triggering actions.\n- **[xh](https://github.com/ducaale/xh)**: Friendly and fast tool for sending HTTP requests.\n\n### Homebrew Casks:\n\n- **[1Password](https://1password.com/)**: A password manager that helps you store and manage your passwords securely.\n- **[1Password CLI](https://developer.1password.com/docs/cli/)**: Command-line interface for 1Password.\n- **[affinity](https://affinity.serif.com/)**: A suite of professional creative software.\n- **[Android Studio](https://developer.android.com/studio)**: The official IDE for Android development.\n- **[brave-browser](https://brave.com/)**: A free and open-source web browser.\n- **[ChatGPT](https://chat.openai.com/)**: Desktop app for interacting with OpenAI's ChatGPT.\n- **[Claude](https://claude.ai/)**: An AI assistant developed by Anthropic.\n- **[Claude Code](https://claude.ai/code)**: A CLI coding assistant by Anthropic.\n- **[Cyberduck](https://cyberduck.io/)**: A libre server and cloud storage browser.\n- **[Discord](https://discord.com/)**: A communication platform for voice, video, and text.\n- **[Figma](https://www.figma.com/)**: A web-based vector graphics editor and prototyping tool.\n- **[font-maple-mono-nf](https://github.com/subframe7536/maple-font)**: A monospace font for developers.\n- **[gcloud-cli](https://cloud.google.com/sdk/gcloud)**: Google Cloud SDK command-line tools.\n- **[ghostty](https://ghostty.app/)**: A modern terminal emulator for macOS.\n- **[GitHub Desktop](https://desktop.github.com/)**: Git client with a graphical interface.\n- **[Google Chrome](https://www.google.com/chrome/)**: A web browser by Google.\n- **[iStat Menus](https://bjango.com/mac/istatmenus/)**: A powerful system monitoring tool for macOS.\n- **[Lens](https://k8slens.dev/)**: The Kubernetes IDE for managing clusters efficiently.\n- **[nordvpn](https://nordvpn.com/)**: A VPN service that provides secure and private internet access.\n- **[OnlyOffice](https://www.onlyoffice.com/)**: A comprehensive office suite for document management and collaboration.\n- **[PHPStorm](https://www.jetbrains.com/phpstorm/)**: A professional IDE for PHP developers from JetBrains.\n- **[Postman](https://www.postman.com/)**: An API platform for building and using APIs.\n- **[Raycast](https://www.raycast.com/)**: A blazingly fast, totally extendable launcher for macOS.\n- **[SF Symbols](https://developer.apple.com/sf-symbols/)**: Apple's icon set for developers.\n- **[Slack](https://slack.com/)**: A collaboration platform for teams to communicate and share files.\n- **[Sublime Text](https://www.sublimetext.com/)**: A sophisticated text editor for code, markup, and prose.\n- **[TablePlus](https://tableplus.com/)**: A modern, native tool for managing relational databases.\n- **[tailscale-app](https://tailscale.com/)**: Zero config VPN for building secure networks.\n- **[Telegram](https://telegram.org/)**: A cloud-based instant messaging, video telephony, and VoIP service.\n- **[Transmission](https://transmissionbt.com/)**: A fast, easy, and free BitTorrent client.\n- **[Visual Studio Code](https://code.visualstudio.com/)**: A lightweight but powerful source code editor.\n- **[VLC](https://www.videolan.org/vlc/)**: A free and open-source cross-platform multimedia player.\n- **[WhatsApp](https://www.whatsapp.com/)**: A free messaging and video calling app.\n- **[Wispr Flow](https://wispr.com/)**: Voice-to-text dictation tool.\n- **[zulu@17](https://www.azul.com/downloads/)**: An open-source build of the Java Development Kit (JDK).\n\n### Mac App Store Applications (installed via `mas`):\n\n- **[Numbers](https://apps.apple.com/us/app/numbers/id409203825?mt=12)**: A spreadsheet application developed by Apple.\n- **[Pages](https://apps.apple.com/us/app/pages/id409201541?mt=12)**: A word processor developed by Apple.\n- **[Permute 3](https://apps.apple.com/us/app/permute-3/id1444998321?mt=12)**: A media converter for macOS.\n- **[Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12)**: An integrated development environment for macOS, iOS, watchOS, and tvOS.\n\n### VSCode Extensions:\n\n- **[anthropic.claude-code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)**: Claude Code extension for VS Code.\n- **[biomejs.biome](https://marketplace.visualstudio.com/items?itemName=biomejs.biome)**: Biome - a fast formatter and linter for JavaScript/TypeScript.\n- **[bradlc.vscode-tailwindcss](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)**: Tailwind CSS IntelliSense.\n- **[catppuccin.catppuccin-vsc](https://marketplace.visualstudio.com/items?itemName=catppuccin.catppuccin-vsc)**: Catppuccin for VSCode.\n- **[catppuccin.catppuccin-vsc-icons](https://marketplace.visualstudio.com/items?itemName=catppuccin.catppuccin-vsc-icons)**: Catppuccin icon theme for VSCode.\n- **[christian-kohler.npm-intellisense](https://marketplace.visualstudio.com/items?itemName=christian-kohler.npm-intellisense)**: Autocompletes npm modules in import statements.\n- **[csstools.postcss](https://marketplace.visualstudio.com/items?itemName=csstools.postcss)**: PostCSS language support.\n- **[denoland.vscode-deno](https://marketplace.visualstudio.com/items?itemName=denoland.vscode-deno)**: Deno support for VS Code.\n- **[dsznajder.es7-react-js-snippets](https://marketplace.visualstudio.com/items?itemName=dsznajder.es7-react-js-snippets)**: ES7+ React/Redux/React-Native snippets.\n- **[eamodio.gitlens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)**: Git supercharged - visualize code authorship and history.\n- **[editorconfig.editorconfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)**: EditorConfig for VS Code.\n- **[expo.vscode-expo-tools](https://marketplace.visualstudio.com/items?itemName=expo.vscode-expo-tools)**: Expo Tools for VS Code.\n- **[github.copilot-chat](https://marketplace.visualstudio.com/items?itemName=github.copilot-chat)**: Chat interface for GitHub Copilot.\n- **[github.vscode-github-actions](https://marketplace.visualstudio.com/items?itemName=github.vscode-github-actions)**: GitHub Actions workflows support.\n- **[ms-azuretools.vscode-containers](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers)**: Docker containers support for VS Code.\n- **[ms-playwright.playwright](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright)**: Run Playwright tests in VS Code.\n- **[ms-python.debugpy](https://marketplace.visualstudio.com/items?itemName=ms-python.debugpy)**: Python debugger for VS Code.\n- **[ms-python.python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)**: Python language support.\n- **[ms-python.vscode-pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance)**: Python language server.\n- **[ms-python.vscode-python-envs](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-python-envs)**: Python environment management.\n- **[prisma.prisma](https://marketplace.visualstudio.com/items?itemName=prisma.prisma)**: Adds syntax highlighting, formatting, auto-completion, jump-to-definition and linting for .prisma files.\n- **[redhat.vscode-yaml](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)**: YAML language support.\n- **[tamasfe.even-better-toml](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)**: TOML language support.\n- **[thang-nm.catppuccin-perfect-icons](https://marketplace.visualstudio.com/items?itemName=thang-nm.catppuccin-perfect-icons)**: Catppuccin-themed file icons.\n- **[xyz.local-history](https://marketplace.visualstudio.com/items?itemName=xyz.local-history)**: A local history of files to recover from accidental changes.\n- **[yzhang.markdown-all-in-one](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)**: Markdown editing support.\n\n## Usefull commands\n\n### Dump Brew bundle\n\nTo keep `Brewfile` up to date any time new software is installed run the following command.\n\n```bash\nbrew bundle dump --force\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanstapol%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanstapol%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanstapol%2Fdotfiles/lists"}