{"id":30695722,"url":"https://github.com/zzev/dotfiles","last_synced_at":"2026-04-08T18:02:23.102Z","repository":{"id":311456685,"uuid":"1043756285","full_name":"zzev/dotfiles","owner":"zzev","description":"Personal dotfiles for vim and tmux","archived":false,"fork":false,"pushed_at":"2025-08-24T20:12:59.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-02T07:08:03.854Z","etag":null,"topics":["configuration","dotfiles","dvorak","macos","shell","terminal","tmux","ubuntu","vim","vundle"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","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/zzev.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}},"created_at":"2025-08-24T14:56:41.000Z","updated_at":"2025-08-24T20:13:02.000Z","dependencies_parsed_at":"2025-08-24T20:04:16.138Z","dependency_job_id":"22a00308-2705-4e18-a308-02d7a071f860","html_url":"https://github.com/zzev/dotfiles","commit_stats":null,"previous_names":["zzev/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zzev/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzev%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzev%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzev%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzev%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zzev","download_url":"https://codeload.github.com/zzev/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zzev%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31567227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["configuration","dotfiles","dvorak","macos","shell","terminal","tmux","ubuntu","vim","vundle"],"created_at":"2025-09-02T07:05:21.225Z","updated_at":"2026-04-08T18:02:23.093Z","avatar_url":"https://github.com/zzev.png","language":"Vim Script","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dotfiles\n\nPersonal dotfiles for vim and tmux with cross-platform compatibility. Features server detection, Dvorak-optimized tmux bindings, Vundle plugin management, and intelligent terminal adaptation for both local development and Ubuntu servers.\n\n  - 🖥️ Cross-platform (macOS + Ubuntu server)\n  - 🎹 Dvorak keyboard optimized tmux navigation\n  - 🎨 Smart color scheme adaptation (true color vs 256-color)\n  - 📦 Automated Vundle plugin management\n  - 🔧 One-command installation with backups\n  - 🖲️ Terminal capability detection (fonts, colors, SSH)\n  - 📜 Session management script with intelligent fallbacks\n\n## Installation\n\n### 1. Clone and install dotfiles\n\nRun the installation script to create symlinks to your home directory:\n\n```bash\n./install.sh\n```\n\nThis will:\n- Create symlinks for vim configuration (`~/.vimrc`)\n- Create symlinks for tmux configuration (`~/.tmux.conf`)\n- Backup any existing configuration files\n\n### 2. Install Vim plugins with Vundle\n\nAfter installing the dotfiles, you need to install Vundle and the vim plugins:\n\n```bash\n# Clone Vundle into the bundle directory\ngit clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim\n\n# Install plugins\nvim +PluginInstall +qall\n```\n\n**Alternative one-liner:**\n```bash\ngit clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim \u0026\u0026 vim +PluginInstall +qall\n```\n\n## Structure\n\n- `vim/` - Vim configuration files\n- `tmux/` - Tmux configuration files\n- `install.sh` - Installation script\n\n## Tmux Key Bindings\n\n- Prefix: `Ctrl+a` (instead of default `Ctrl+b`)\n- Split panes: `|` (horizontal) and `-` (vertical)\n- Reload config: `Prefix + y`\n- Navigate panes: `r` (left), `t` (down), `n` (up), `s` (right) - Dvorak optimized\n- Resize panes: `R`, `T`, `N`, `S` (repeatable)\n- Window navigation: `Alt + 1-9` (direct window selection)\n\n## Tmux Session Management Script\n\nThe repository includes `load_tmux.sh` - a convenient script for managing tmux sessions.\n\n### Setup the alias in your shell:\n\n**For bash (~/.bashrc):**\n```bash\n# Add this line to your ~/.bashrc\nalias tmux-load=\"~/Code/personal/dotfiles/tmux/load_tmux.sh\"\n```\n\n**For zsh (~/.zshrc):**\n```bash\n# Add this line to your ~/.zshrc\nalias tmux-load=\"~/Code/personal/dotfiles/tmux/load_tmux.sh\"\n```\n\nThen reload your shell: `source ~/.bashrc` or `source ~/.zshrc`\n\n### Usage:\n```bash\ntmux-load              # Attach to 'main' session or first available\ntmux-load work         # Attach to or create 'work' session\ntmux-load --list       # List all available sessions\ntmux-load --help       # Show help\n```\n\n**Features:**\n- Auto-attaches to existing sessions or creates new ones\n- Intelligent fallback (tries default → any session → create new)\n- Lists available sessions with details\n- Prevents nested tmux sessions\n\n## Vim Plugins Included\n\nThe vim configuration uses Vundle and includes these plugins:\n- **Vundle** - Plugin manager\n- **ack.vim** - Text searching\n- **ctrlp.vim** - Fuzzy file finder\n- **ALE** - Asynchronous linting\n- **tagbar** - Code outline viewer\n- **vim-airline** - Status line enhancement\n- **vim-bundler** - Ruby Bundler support\n- **vim-fugitive** - Git integration\n- **vim-rails** - Ruby on Rails support\n- **bufexplorer** - Buffer navigation\n- **ayu-vim** - Color theme\n- **typescript-vim** - TypeScript syntax\n\n## Environment-Specific Setup\n\n### Ubuntu Server Setup\nThe vim configuration automatically detects server environments (SSH, no DISPLAY, etc.) and uses:\n- Conservative 256-color support (no true colors)\n- ASCII-only airline symbols (no powerline fonts needed)\n- Server-friendly color schemes (desert, slate, darkblue)\n\n**Ubuntu/Debian dependencies:**\n```bash\n# Install vim and git\nsudo apt update\nsudo apt install vim git curl\n\n# Optional: Install ack for ack.vim plugin\nsudo apt install ack-grep\n```\n\n### macOS/Local Terminal Setup\nFor better visual experience on local terminals:\n\n**Font Requirements:**\n```bash\n# Install a powerline font (choose one)\nbrew install --cask font-monaco-for-powerline\n# or\nbrew install --cask font-meslo-lg-nerd-font\n# or\nbrew install --cask font-fira-code-nerd-font\n```\n\n**Terminal Color Support:**\n\n**iTerm2 (recommended):**\n- Preferences → Profiles → Colors → Color Presets → choose a 256-color theme\n- Enable \"Report terminal type as: xterm-256color\"\n\n**Terminal.app:**\n- Preferences → Profiles → Advanced → Declare terminal as: xterm-256color\n\n**Test color support:**\n```bash\n# Test 256 color support\ncurl -s https://gist.githubusercontent.com/HaleTom/89ffe32783f89f403bba96bd7bcd1263/raw/ | bash\n\n# Check environment detection\necho \"DISPLAY: $DISPLAY\"\necho \"SSH_CLIENT: $SSH_CLIENT\"\necho \"TERM: $TERM\"\n```\n\n## Notes\n\nAfter installation, you may need to:\n- Restart your terminal\n- Source your tmux config: `tmux source ~/.tmux.conf`\n- Install any additional dependencies for vim plugins (e.g., `ack` command for ack.vim)\n- Set your terminal font to a powerline-compatible font for proper icons\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzzev%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzzev%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzzev%2Fdotfiles/lists"}