mauvehed's dotfiles for personal and work environments

User Applications Usage#

This document lists common user (GUI) applications that are part of this development and productivity setup. It also notes if and how their configurations might be managed by chezmoi.

Overview#

While chezmoi excels at managing command-line tool configurations (dotfiles), it can also help manage settings for some GUI applications, typically by symlinking or templating their preference files (e.g., .plist files on macOS, JSON/XML configs).

Many applications are installed via Homebrew Cask on macOS. Check your Brewfile (if used with chezmoi) or chezmoi installation scripts for a list of managed applications.

Common Application Categories & Examples#

Below are categories and examples of applications that might be part of your setup. Add your specific applications to these lists.

Web Browsers#

  • Google Chrome
    • Installation: Homebrew Cask (brew install --cask google-chrome) or manual download.
    • Configuration: User profile settings are complex to manage directly with dotfiles. Consider using Chrome's built-in sync feature.
  • Mozilla Firefox
    • Installation: Homebrew Cask (brew install --cask firefox) or manual download.
    • Configuration: Profile-based. Some user.js customizations can be managed.
  • Safari (macOS)
    • Installation: Comes with macOS.
    • Configuration: Some .plist files in ~/Library/Preferences/ or ~/Library/Containers/com.apple.Safari/Data/Library/Preferences/ might be manageable, but can be complex.

Productivity Tools#

  • Rectangle (macOS Window Manager)
    • Installation: Homebrew Cask (brew install --cask rectangle) or manual download.
    • Configuration: Preferences (~/Library/Preferences/com.knollsoft.Rectangle.plist) can often be managed by chezmoi.
  • Alfred (macOS Launcher & Productivity)
    • Installation: Homebrew Cask (brew install --cask alfred) or manual download.
    • Configuration: Alfred preferences can be synced to a folder (e.g., Dropbox, iCloud Drive), and chezmoi could potentially manage a symlink to this sync folder or specific non-sensitive parts of its config if exported.
  • Obsidian (Knowledge Base/Notes)
    • Installation: Homebrew Cask (brew install --cask obsidian) or manual download.
    • Configuration: Vaults are user-managed. Some global configuration files might be linkable.
  • Password Manager (GUI)
    • 1Password: (Covered in docs/1password-usage.md for CLI, GUI is complementary)

Development Tools (GUI)#

  • Visual Studio Code: (Covered in detail in docs/vscode-usage.md)
  • Docker Desktop: (Covered in docs/docker-usage.md)
  • Database GUI Clients (e.g., TablePlus, DBeaver, pgAdmin)
    • Example: TablePlus
      • Installation: Homebrew Cask (brew install --cask tableplus) or manual download.
      • Configuration: Connection details are typically managed within the app; general preferences might be in a .plist file.
  • API Clients (e.g., Postman, Insomnia)
    • Example: Postman
      • Installation: Homebrew Cask (brew install --cask postman) or manual download.
      • Configuration: Typically uses cloud sync for collections and environments.

Communication#

  • Slack
    • Installation: Homebrew Cask (brew install --cask slack) or manual download.
  • Zoom
    • Installation: Homebrew Cask (brew install --cask zoom) or manual download.

Other Utilities#

  • Spotify
    • Installation: Homebrew Cask (brew install --cask spotify) or manual download.
  • VLC Media Player
    • Installation: Homebrew Cask (brew install --cask vlc) or manual download.

Managing Application Settings with chezmoi#

If an application stores its settings in a known file path (e.g., a .plist file in ~/Library/Preferences/ on macOS, or a JSON/INI/XML file in ~/.config/AppName/ on Linux), chezmoi can manage it:

  1. Identify the configuration file.
  2. Copy it to your chezmoi source directory (e.g., as private_Library/Preferences/com.example.app.plist for macOS, or dot_config/AppName/settings.json).
  3. Add it to chezmoi: chezmoi add ~/Library/Preferences/com.example.app.plist (using the original path).
  4. chezmoi will then create a symlink from the target path to your source directory version, or apply it as a template.

Caution: Some applications do not like their preference files being symlinked or modified externally while they are running. Test thoroughly.

Resources#

This document is a template. Please populate it with the specific applications you use and how you manage their installation and configuration.