{"id":25303578,"url":"https://github.com/niklasbogensperger/zsh-setup","last_synced_at":"2026-05-08T06:53:16.531Z","repository":{"id":51445581,"uuid":"520441608","full_name":"niklasbogensperger/zsh-setup","owner":"niklasbogensperger","description":"My zsh setup files to be loaded in .zshrc","archived":false,"fork":false,"pushed_at":"2025-04-22T20:28:59.000Z","size":40,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-19T11:03:47.145Z","etag":null,"topics":["macos","shell","zsh","zshrc","zshrc-configs"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/niklasbogensperger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-08-02T09:55:39.000Z","updated_at":"2025-04-22T20:29:02.000Z","dependencies_parsed_at":"2025-09-19T10:45:41.727Z","dependency_job_id":"4473641c-0184-4058-8e01-cfdb4e54ba61","html_url":"https://github.com/niklasbogensperger/zsh-setup","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/niklasbogensperger/zsh-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niklasbogensperger%2Fzsh-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niklasbogensperger%2Fzsh-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niklasbogensperger%2Fzsh-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niklasbogensperger%2Fzsh-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/niklasbogensperger","download_url":"https://codeload.github.com/niklasbogensperger/zsh-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niklasbogensperger%2Fzsh-setup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32770544,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T02:36:36.067Z","status":"ssl_error","status_checked_at":"2026-05-08T02:36:07.210Z","response_time":54,"last_error":"SSL_read: 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":["macos","shell","zsh","zshrc","zshrc-configs"],"created_at":"2025-02-13T07:37:00.439Z","updated_at":"2026-05-08T06:53:16.511Z","avatar_url":"https://github.com/niklasbogensperger.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zsh-setup[^1]\n\n\n## Preliminary steps\n1. Install `oh-my-zsh` ([GitHub](https://github.com/ohmyzsh/ohmyzsh))\n2. Install `powerlevel10k` ([GitHub](https://github.com/romkatv/powerlevel10k))\n\n\n## Configuration\n\n### `.zshrc`\n\n1. change oh-my-zsh theme to `powerlevel10k/powerlevel10k`\n2. add the following code block _before the last line_ (powerlevel10k requirement)\n```shell\n# import my own files\nZSHCONFIG=\"path to zsh config files (without any quotes)\"\nfor config in ${ZSHCONFIG}*.zsh; do\n  source \"${config}\"\ndone\nunset config\nZSHFUNCT=\"path to zsh function files (without any quotes)\"\nfor funct in ${ZSHFUNCT}*.zsh; do\n  source \"${funct}\"\ndone\nunset funct\n```\n\n\n### `powerlevel10k` configurator\n\n1. classic prompt style\n2. unicode\n3. darkest\n4. no time\n5. angled separators\n6. sharp heads\n7. flat tails\n8. one line prompt\n9. compact line spacing\n10. few icons\n11. concise prompt flow\n12. enable transient prompt\n\n\n### `.p10k.zsh`\n\n- uncomment `vpn_ip` (right prompt element) to enable vpn indicator\n- set command execution time threshold to `0`\n- set command execution time precision to `2`\n- set vcs branch icon to `'\\uF126 '`\n\n\n## Files\n\n### `configs` folder\n\n| file              | content                                                    |\n| ----------------- | ---------------------------------------------------------- |\n| `aliases.zsh`     | command aliases for default flags, shortcuts, replacements |\n| `environment.zsh` | environment variables                                      |\n| `options.zsh`     | zsh options and settings                                   |\n| `path.zsh`        | additions to `$PATH` and similar variables                 |\n\n\n### `functions` folder\n\n| file                               | group                                                        | action                                                       |\n| ---------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| `01_decryptfile.zsh`               | 01 - encrypting and decrypting files with `gpg`/`gnupg`      | decrypting a file                                            |\n| `01_encryptfile.zsh`               | ⬆︎                                                            | encrypting a file                                            |\n| `01_tmpdecryptfile.zsh`            | ⬆︎                                                            | non-persistently decrypting a file and only displaying its contents |\n| `02_gitignore.zsh`                 | 02 - creating comprehensive .gitignore files via a public [API](https://www.toptal.com/developers/gitignore) | returns output of API according to parameters (usually write to file) |\n| `03_externalmonitor.zsh`           | 03 - opening and closing useful apps when using external monitors | opens relevant apps                                          |\n| `03_internalmonitor.zsh`           | ⬆︎                                                            | closes relevant apps                                         |\n| `04_appidentifier.zsh`             | 04 - displaying the macOS bundle identifier of apps          | returns bundle identifier                                    |\n| `05_cleanhelpers.zsh`              | 05 - creating clean zip \u0026 tar files (by excluding hidden files/directories and macOS-specific special files) | helper functions for `cleantar` \u0026 `cleanzip`                 |\n| `05_cleantar.zsh`                  | ⬆︎                                                            | creates a clean tar archive                                  |\n| `05_cleanzip.zsh`                  | ⬆︎                                                            | creates a clean zip archive                                  |\n| `06_checkhash.zsh`                 | 06 - computing file hashes (and optionally checking it against a provided hash) | returns file hashes or comparison result                     |\n| `07_pwgen.zsh`                     | 07 - generating random passwords of desired length in base64 encoding | returns randomly generated password                          |\n| `08_setname.zsh`                   | 08 - setting the file name of photos/videos to one of the timestamps embedded in the metadata tags | updates image filename(s) according to user selection        |\n| `09_uv-default.zsh`                | 09 - managing a (default) python `venv` created by `uv`      | aliases the `uv` command to run in the default environment directory |\n| `09_uv-default-python-upgrade.zsh` | ⬆︎                                                            | upgrades the base python version used by the default environment |\n| `09_uv-upgrade.zsh`                | ⬆︎                                                            | upgrades the packages in any `uv` environment                |\n\n\n[^1]: my system is macOS, YMMV on other platforms\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniklasbogensperger%2Fzsh-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fniklasbogensperger%2Fzsh-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniklasbogensperger%2Fzsh-setup/lists"}