{"id":13740061,"url":"https://github.com/vascomfnunes/tmux-clima","last_synced_at":"2025-05-08T19:35:31.862Z","repository":{"id":107910525,"uuid":"411779435","full_name":"vascomfnunes/tmux-clima","owner":"vascomfnunes","description":"A tmux weather statusbar plugin.","archived":false,"fork":false,"pushed_at":"2024-09-09T22:40:25.000Z","size":164,"stargazers_count":8,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-09-10T03:10:08.668Z","etag":null,"topics":["tmux","tmux-plugins"],"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/vascomfnunes.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":"2021-09-29T18:01:42.000Z","updated_at":"2024-09-09T22:40:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"df1e9691-c863-4603-b56d-9cf245d025a2","html_url":"https://github.com/vascomfnunes/tmux-clima","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vascomfnunes%2Ftmux-clima","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vascomfnunes%2Ftmux-clima/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vascomfnunes%2Ftmux-clima/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vascomfnunes%2Ftmux-clima/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vascomfnunes","download_url":"https://codeload.github.com/vascomfnunes/tmux-clima/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224758272,"owners_count":17364974,"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":["tmux","tmux-plugins"],"created_at":"2024-08-03T04:00:41.977Z","updated_at":"2024-11-15T09:31:00.364Z","avatar_url":"https://github.com/vascomfnunes.png","language":"Shell","funding_links":[],"categories":["Status Bar"],"sub_categories":[],"readme":"# Clima\n\n![https://github.com/vascomfnunes/tmux-clima/blob/main/media/img/shot.png](https://github.com/vascomfnunes/tmux-clima/blob/main/media/img/shot.png)\n\n**Clima (Esperanto for weather) is a simple plugin that displays the local\nweather conditions and temperature in your Tmux status line.**\n\nBy default, the location is obtained automatically using your IP address. You can it set to a specific location using an\noption `@clima.location`\n\nResults are cached for 15 minutes by default.\n\n## Requirements\n\n### OpenWeatherMap API key\n\nThe weather information is provided by\n[OpenWeatherMap](https://openweathermap.org/). To use this plugin you need a\nvalid OpenWeather API key that can be request\n[here](https://openweathermap.org/api).\n\nAn environment variable named `OPEN_WEATHER_API_KEY` with the API key value\nshould be exported to use this plugin:\n\n```bash\nexport OPEN_WEATHER_API_KEY=\"[API-KEY-VALUE]\"\n```\n\nYou can add this to your shell configuration or source it from any other file.\n\n### Other dependencies\n\nMake sure you have [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm)\nand [jq](https://stedolan.github.io/jq/download/) installed.\n\n## Install\n\nThen add the plugin to your `~/.tmux.conf`:\n\n```tmux\nset -g @plugin 'vascomfnunes/tmux-clima'\n```\n\nLoad the plugin with `prefix + I`.\n\n## Usage\n\nYou can add `#{clima}` to your status line configuration if it already exists.\n\nFor example:\n\n```tmux\nset -g status-right \"#{clima}\"\n```\n\nCurrent weather details can be visualized using `prefix + W`, which will display\na standard tmux message with additional weather details:\n\n![https://github.com/vascomfnunes/tmux-clima/blob/main/media/img/details.png](https://github.com/vascomfnunes/tmux-clima/blob/main/media/img/details.png)\n\n## Configuration\n\n### Time-to-live (TTL)\n\nThis plugin caches the weather by default for 15 minutes. You can set any other\nTTL value (in minutes) using the option:\n\n```bash\nset -g @clima_ttl \u003cvalue_in_minutes\u003e\n```\n\n### Unit\n\nWeather temperature unit can be configured through following option (default is 'metric')\n\n```bash\nset -g @clima_unit \u003cmetric | imperial | kelvin\u003e\n```\n\n### Location\n\nYou can choose not to show the location in the statusbar with the following\noption:\n\n```bash\nset -g @clima_show_location 0\n```\n\nSet up your location using the following option, by default you will get the weather for your current location based on\nyour IP address\n\n```bash\nset -g @clima_location \"Melbourne\"\n```\n\nBy default it always show the location in the statusbar.\n\n### Icons\n\nYou can choose not to show the weather condition icon in the statusbar with the\nfollowing option:\n\n```bash\nset -g @clima_show_icon 0\n```\n\nBy default it always show the icon in the statusbar.\n\n#### Nerd Fonts\n\nIcons are displayed by default using unicode symbols. If you are using a patched\n[Nerd Font](https://www.nerdfonts.com/) and prefer to use Nerd Icons:\n\n```bash\nset -g @clima_use_nerd_font 1\n```\n\n## License\n\nThis plugin is licensed under the MIT license. For more information please refer\nto the [LICENSE](https://github.com/vascomfnunes/tmux-clima/blob/main/LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvascomfnunes%2Ftmux-clima","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvascomfnunes%2Ftmux-clima","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvascomfnunes%2Ftmux-clima/lists"}