{"id":15114306,"url":"https://github.com/adriankarlen/bar.wezterm","last_synced_at":"2025-12-29T23:41:13.083Z","repository":{"id":238819905,"uuid":"797614886","full_name":"adriankarlen/bar.wezterm","owner":"adriankarlen","description":"A wezterm tab bar with batteries included","archived":false,"fork":false,"pushed_at":"2025-01-09T21:48:06.000Z","size":2076,"stargazers_count":93,"open_issues_count":1,"forks_count":17,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-09T22:44:43.566Z","etag":null,"topics":["multiplexing","rice","ricing","shell","terminal","unix","wezterm","windows"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/adriankarlen.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}},"created_at":"2024-05-08T07:25:20.000Z","updated_at":"2025-01-09T21:48:09.000Z","dependencies_parsed_at":"2024-05-13T07:30:15.642Z","dependency_job_id":"37761679-925f-492b-8e8f-bbb4a942af00","html_url":"https://github.com/adriankarlen/bar.wezterm","commit_stats":null,"previous_names":["adriankarlen/bar.wezterm"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriankarlen%2Fbar.wezterm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriankarlen%2Fbar.wezterm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriankarlen%2Fbar.wezterm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriankarlen%2Fbar.wezterm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adriankarlen","download_url":"https://codeload.github.com/adriankarlen/bar.wezterm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234450841,"owners_count":18834586,"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":["multiplexing","rice","ricing","shell","terminal","unix","wezterm","windows"],"created_at":"2024-09-26T01:41:11.455Z","updated_at":"2025-09-27T18:30:39.355Z","avatar_url":"https://github.com/adriankarlen.png","language":"Lua","funding_links":[],"categories":["Tab bar","Lua"],"sub_categories":[],"readme":"# 🍺 bar.wezterm\n\nA tab bar configuration for wezterm, this configuration is heavily inspired by [rose-pine/tmux](https://github.com/rose-pine/tmux).\n\n## 📷\n\n![image](https://raw.githubusercontent.com/adriankarlen/bar.wezterm/main/misc/preview.png)\n\n### 🌷 Rosé Pine\n\n![image](https://raw.githubusercontent.com/adriankarlen/bar.wezterm/main/misc/rose-pine.png)\n\n### 😸 Catppuccin Mocha\n\n![image](https://raw.githubusercontent.com/adriankarlen/bar.wezterm/main/misc/catppuccin-mocha.png)\n\u0026nbsp;\n\n## 📋 Prerequisites\n\n### 🎵Spotify\n\nIn order for the spotify integration to work you need to have [spotify-tui](https://github.com/Rigellute/spotify-tui) installed on you system. Follow their installation instructions on how to set it up.\n\n\u003e [!NOTE]\n\u003e bar.wezterm ships with this module disabled, please check example in\n\u003e [Configuration](#%EF%B8%8F-configuration) on how to enable it.\n\n\u0026nbsp;\n\n## 🚀 Installation\n\nThis is a wezterm [plugin](https://github.com/wez/wezterm/commit/e4ae8a844d8feaa43e1de34c5cc8b4f07ce525dd). It can be installed by importing the repo and calling the apply_to_config-function. It is important that the `apply_to_config`-function is called after `color_scheme` has been set.\n\n```lua\nlocal bar = wezterm.plugin.require(\"https://github.com/adriankarlen/bar.wezterm\")\nbar.apply_to_config(config)\n```\n\n\u003e [!NOTE]\n\u003e This assumes that you have imported the wezterm module and initialized the config-object.\n\n\u0026nbsp;\n\n## 🛠️ Configuration\n\nThe `apply_to_config`-function takes a second param `opts`. To override any options simply pass a table of the desired changes.\n\n```lua\n-- example enable spotify module\nbar.apply_to_config(\n  config,\n  {\n    modules = {\n      spotify = {\n        enabled = true,\n      },\n    },\n  }\n)\n```\n\n### 🏭 Default configuration\n\n\u003e [!IMPORTANT]\n\u003e The default config requires that you are using a Nerd Font or has \"Symbols Nerd Font\" installed on your system so wezterm can default to it.\n\n```lua\nlocal config = {\n  position = \"bottom\",\n  max_width = 32,\n  padding = {\n    left = 1,\n    right = 1,\n    tabs = {\n      left = 0,\n      right = 2,\n    },\n  },\n  separator = {\n    space = 1,\n    left_icon = wez.nerdfonts.fa_long_arrow_right,\n    right_icon = wez.nerdfonts.fa_long_arrow_left,\n    field_icon = wez.nerdfonts.indent_line,\n  },\n  modules = {\n    tabs = {\n      active_tab_fg = 4,\n      inactive_tab_fg = 6,\n      new_tab_fg = 2,\n    },\n    workspace = {\n      enabled = true,\n      icon = wez.nerdfonts.cod_window,\n      color = 8,\n    },\n    leader = {\n      enabled = true,\n      icon = wez.nerdfonts.oct_rocket,\n      color = 2,\n    },\n    zoom = {\n      enabled = false,\n      icon = wez.nerdfonts.md_fullscreen,\n      color = 4,\n    },\n    pane = {\n      enabled = true,\n      icon = wez.nerdfonts.cod_multiple_windows,\n      color = 7,\n    },\n    username = {\n      enabled = true,\n      icon = wez.nerdfonts.fa_user,\n      color = 6,\n    },\n    hostname = {\n      enabled = true,\n      icon = wez.nerdfonts.cod_server,\n      color = 8,\n    },\n    clock = {\n      enabled = true,\n      icon = wez.nerdfonts.md_calendar_clock,\n      format = \"%H:%M\",\n      color = 5,\n    },\n    cwd = {\n      enabled = true,\n      icon = wez.nerdfonts.oct_file_directory,\n      color = 7,\n    },\n    spotify = {\n      enabled = false,\n      icon = wez.nerdfonts.fa_spotify,\n      color = 3,\n      max_width = 64,\n      throttle = 15,\n    },\n  },\n}\n```\n\n### 🎨 Colors\n\nEvery ansi color used is configurable, to change a color, pass in the desired\nansi code to use for a specific setting.\n\nIf you want to change any other color used, since the plugin uses your themes colors you can configure the theme to get a different result. For instance, if I want to change the active tab background color I can do so like this:\n\n```lua\nreturn {\n  -- ... your existing config\n  colors = {\n    tab_bar = {\n      active_tab = {\n        bg_color = \"#26233a\"\n      }\n    }\n  }\n}\n```\n\n#### 🖌️ Color table\n\n| Color option                    | Default       |\n| ------------------------------- | ------------- |\n| `tab_bar.background`            | `transparent` |\n| `tab_bar.active_tab.bg_color`   | `transparent` |\n| `tab_bar.inactive_tab.bg_color` | `transparent` |\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the\n[LICENSE](https://github.com/adriankarlen/bar.wezterm/blob/main/LICENSE) file\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadriankarlen%2Fbar.wezterm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadriankarlen%2Fbar.wezterm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadriankarlen%2Fbar.wezterm/lists"}