{"id":13539657,"url":"https://github.com/hohmannr/bubblified","last_synced_at":"2025-04-02T06:31:15.894Z","repository":{"id":168217788,"uuid":"252509358","full_name":"hohmannr/bubblified","owner":"hohmannr","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-13T19:58:36.000Z","size":573,"stargazers_count":76,"open_issues_count":1,"forks_count":7,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-03T04:32:41.671Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/hohmannr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2020-04-02T16:31:33.000Z","updated_at":"2024-10-17T09:26:41.000Z","dependencies_parsed_at":"2024-08-01T09:23:28.718Z","dependency_job_id":null,"html_url":"https://github.com/hohmannr/bubblified","commit_stats":null,"previous_names":["hohmannr/bubblified"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hohmannr%2Fbubblified","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hohmannr%2Fbubblified/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hohmannr%2Fbubblified/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hohmannr%2Fbubblified/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hohmannr","download_url":"https://codeload.github.com/hohmannr/bubblified/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246767855,"owners_count":20830569,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-01T09:01:30.087Z","updated_at":"2025-04-02T06:31:11.884Z","avatar_url":"https://github.com/hohmannr.png","language":"Shell","readme":"# Bubblified zsh-theme\n\n![bubblified.gif](https://raw.githubusercontent.com/hohmannr/bubblified/master/pics/bubblified.gif)\n\nA zsh-theme inspired by [agnoster](https://github.com/agnoster/agnoster-zsh-theme) and [bubblewritten](https://github.com/paracorde/dots/blob/master/bubblewritten.zsh-theme).\n\n**Best used with [ohmyzsh](https://github.com/ohmyzsh/ohmyzsh) and powered by [nerdfonts](https://github.com/ryanoasis/nerd-fonts)**\n\n## Installation\n\n### Antigen\n\nPlace the following line in the [right](https://github.com/zsh-users/antigen) spot of your `.zshrc`\n\n```\nantigen theme hohmannr/bubblified\n```\n\n\n### Manual\n\n***Assuming you are using ohmyzsh***.\n\nGet the sourcefile\n```\n$ wget https://raw.githubusercontent.com/hohmannr/bubblified/master/bubblified.zsh-theme\n```\n\nMove it to your ohmyzsh theme folder\n```\n$ mv bubblified.zsh-theme $ZSH/themes\n```\n\nOpen your `.zshrc` and change the theme\n```\nZSH_THEME=\"bubblified\"\n```\n\nRestart your terminal emulator and enjoy.\n\n## Features\n\n### Git support\n\nThe theme's git parser adds two level of git information. Firstly, it colors all common git states differently. Secondly, it gives detailed change information by displaying a variety of icons.\n\n**State Colors**\n\n- `green` – clean branch\n- `yellow` – unstaged changes\n- `magenta` – all changes are staged\n- `blue` – there are stashed changes for this branch\n- `red` – unmerged changes/merge conflict\n\n**Icons**\n\n- `•` – indexed file modified\n- `` – file added to index\n- `` – indexed file removed\n- `` – indexed file renamed\n- `裸` – untracked file\n- `` – indexed file copied\n\n![git-demo.png](https://raw.githubusercontent.com/hohmannr/bubblified/master/pics/git-demo.png)\n\n### SSH Support\n\nIf you are installing this theme on a ssh-machine, it automatically detects when you connect to this machine and displays a ssh symbol. You can freely choose this symbol and the bubble color for every ssh-machine that you manage, making them easily differentiable. Check the **Customization** section for further information.\n\n![ssh-demo.png](https://raw.githubusercontent.com/hohmannr/bubblified/master/pics/ssh-demo.png)\n\n### 256 Color support\n\nThis theme supports 256 colors, you can use zsh-color-codes (get a list by running the command `spectrum_ls`) or the traditional zsh-color-strings (e.g. `'red'`). Check the **Customization** section for further information.\n\n![256-colors-demo.png](https://raw.githubusercontent.com/hohmannr/bubblified/master/pics/256-colors-demo.png)\n\n## Customization\n\nThis theme is built with customization in mind. This means that you should be able to customize colors and icons aswell as add custom bubbles in the theme's style.\n\n### What to do before\n\n***Assuming you are using ohmyzsh***.\n\nBefore customization please copy this theme to ohmyzsh's custom theme directory.\n```\n$ cp $ZSH/themes/bubblified.zsh-theme $ZSH/custom/themes\n```\n\nThen edit the theme using your favorite editor, mine is neovim.\n```\n$ nvim $ZSH/custom/themes/bubblified.zsh-theme\n```\nTo load the edited theme, restart your terminal emulator or source your `.zshrc`.\n```\n$ source ~/.zshrc\n```\n\n### Icons\n\nTo change icons for the default bubbles, just change their constants under the `# SYMBOL CONSTANTS` section.\n\n### Colors\n\nTo change colors for the default bubbles, just change their constants under the `# COLOR CONSTANTS` section. Valid values are `{'black', 'red', 'blue', 'cyan', 'yellow', 'green', 'white', 'magenta'}`, they correspond to the colors set in your terminal.\n\n```\nfilepath_color='blue'\n```\n\nYou can also use zsh-color-codes for a wider spectrum of 256 colors (use the command `spectrum_ls` for a complete list). When working with color codes, make sure that you set all three digits.\n\n```\nfilepath_color='078'\n```\n\n### SSH\n\n***Assuming you have installed the theme ON your SSH-MACHINE.***\n\nTo change the icon and the colors (including the bubble's color) you have to customize the theme **on your ssh-machine**.\n\n### Custom Bubbles\n\n#### Simple Bubbles\n\nSimple bubbles are bubbles with the default `bubble_color` and content.\nDeclare a variable (e.g. the current time)\n\n```\ntime_bubble=\"%T\"\n```\n    \nBuild a bubble by enclosing the variable with `$bubble_left` and `$bubble_right`.\n\n```\ntime_bubble=\"$bubble_left%T$bubble_right\"\n```\n\n*OPTIONAL* - If you want a different text color, then add an escape sequence with the color definition or achieve 256 color support by using the in-built foreground function and a zsh-color-string or a zsh-color-code.\n\n```\ntime_bubble=\"$bubble_left%{$fg[red]%}%T$bubble_right\"\n# or\ntime_bubble=\"$bubble_left$(foreground '073')%T$bubble_right\"\n```\n\nAdd the variable to the `PROMPT`.\n\n```\nPROMPT='...$time_bubble...'\n```\n\n#### Fancy Bubbles\n\nFancy bubbles are in the style of the default `git_bubble`. They consist of multiple segments for which the text and the background can be colored individually.\nDefine a custom function that echos the bubble's content.\n\n```\nfoo () {\n    echo -n \"left middle right\"\n}\n```\n\nUse the provided `bubblify` function to build custom colored bubble segments.\n\n```\nfoo () {\n    echo -n \"$(bubblify 0 \"left\" \"black\" \"red\")$(bubblify 1 \"middle\" \"green\" \"black\")$(bubblify \"right\" \"yellow\" \"magenta\")\"\n}\n```\n\n*TIP* - `bubblify {0, 1, 2, 3} \"foreground-color\" \"background-color\"` where `0` builds a left segment, `1` builds a middle segment, `2` builds a right segment and `3` builds a whole custom colored bubble with only one segment. \"foreground-color\" and \"background-color\" can be used with zsh-color-strings or zsh-color-codes.\n\n*TIP* - Including `%{$reset_color%}` at the end of the echo will make sure that colors are reset to the default ones after your bubble finishes rendering.\n\nAdd the function as a subshell call to the `PROMPT`.\n\n```\nPROMPT='...$(foo)...'\n```\n\n## Changelog\n\n- version 0.3:\n    - added git functionality\n    - fastified git parser\n\n- version 0.2:\n    - added ssh support\n    - added 256 color support\n\n- version 0.1.2:\n    - removed unnecessary escape sequences\n\n- version 0.1.1:\n    - fixed bug in `bubblify` where function description and README suggested the wrong building order for `$1`\n\n- version 0.1:\n    - initial commit\n\n","funding_links":[],"categories":["Themes","Shell"],"sub_categories":["ZSH on Windows"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhohmannr%2Fbubblified","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhohmannr%2Fbubblified","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhohmannr%2Fbubblified/lists"}