https://github.com/longpdo/bitbar-plugins-custom
Collection of BitBar plugins I wrote myself or tweaked to my liking.
https://github.com/longpdo/bitbar-plugins-custom
bitbar bitbar-plugin bitbar-plugins
Last synced: 11 months ago
JSON representation
Collection of BitBar plugins I wrote myself or tweaked to my liking.
- Host: GitHub
- URL: https://github.com/longpdo/bitbar-plugins-custom
- Owner: longpdo
- License: mit
- Created: 2020-04-18T16:48:58.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-05-22T22:43:28.000Z (almost 3 years ago)
- Last Synced: 2025-04-12T00:12:47.287Z (11 months ago)
- Topics: bitbar, bitbar-plugin, bitbar-plugins
- Language: Shell
- Homepage:
- Size: 23.6 MB
- Stars: 5
- Watchers: 1
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BitBar-Plugins-Custom
> Collection of BitBar plugins I wrote myself or tweaked to my liking.
[](https://github.com/longpdo/bitbar-plugins-custom/issues)
[](LICENSE)
[Report Bug](https://github.com/longpdo/bitbar-plugins-custom/issues) · [Request Feature](https://github.com/longpdo/bitbar-plugins-custom/issues)
## Table of Contents
* [About The Project](#about-the-project)
* [Plugins I am currently using](#plugins-i-am-currently-using)
* [Plugins I wrote](#plugins-i-wrote)
* [Yahoo Stock Ticker](#yahoo-stock-ticker)
* [Social Media Stats](#social-media-stats)
* [Getting Started](#getting-started)
* [Prerequisites](#prerequisites)
* [Installation](#installation)
* [Usage](#usage)
* [Contributing](#contributing)
* [License](#license)
* [Acknowledgements](#acknowledgements)
## About The Project
[![Product Screenshot][product-screenshot]](https://github.com/longpdo/bitbar-plugins-custom)
This repo contains scripts, programs and command-line tools that add functionality to [BitBar](https://github.com/matryer/bitbar#get-started).
### Plugins I am currently using
* [Yahoo Stock Ticker](https://github.com/longpdo/bitbar-plugins-custom/blob/master/plugins/yahoo_stock_ticker.18m.py)
* [Clipboard History](https://getbitbar.com/plugins/System/clipboard-history.3s.sh)
* [Countdown Timer 2](https://getbitbar.com/plugins/Time/countdown_timer_2.1s.py)
* [Colorful Battery Indicator](https://getbitbar.com/plugins/System/ColorfulBatteryLevel.5s.sh)
* Added the remaining time to show in the menu bar, when the battery is discharging
* [Yahoo Weather](https://getbitbar.com/plugins/Weather/yahoo-weather.5m.py)
* Simplified to only show the temperature in the menu bar
* Added weather forecast for the next days in the dropdown view
[![Yahoo Weather Screenshot][yahoo-weather-screenshot]](https://github.com/longpdo/bitbar-plugins-custom/blob/master/plugins/yahoo-weather.1h.py)
* [Clock with calendar](https://getbitbar.com/plugins/Time/CalendarLite.1m.sh)
* Tweaked the format of the date displayed in the menu bar
[![CalenderLite Screenshot][calendarlite-screenshot]](https://github.com/longpdo/bitbar-plugins-custom/blob/master/plugins/CalendarLite.1s.sh)
### Plugins I wrote
#### [Yahoo Stock Ticker](https://getbitbar.com/plugins/Finance/yahoo_stock_ticker.10m.py)
Dependencies: Python3 (there is also a version of this in [Bash](https://github.com/longpdo/bitbar-plugins-custom/blob/master/deactivated-plugins/yahoo-stock-ticker.5m.sh), but without the price alarm functionality)
* Pulls stock information from the Yahoo Finance API v7
* Shows major stock indices in the menu bar
* Shows stock symbols in the dropdown menu with additional information in the submenus
* Orders stock symbols by user configuration (alphabetically, market change by value ascending or descending or by absolute value)
[![Yahoo Stock Ticker Screenshot 1][yahoo-stock-ticker]](https://github.com/longpdo/bitbar-plugins-custom/blob/master/plugins/yahoo_stock_ticker.18m.py)
* Able to set price alarms for BUY or SELL limits for each stock in the watchlist
* Notifies you if current stock price is lower than your set BUY limit
* Notifies you if current stock price is greater than your set SELL limit
* Remove one of your price limits by clicking on it
* Clear all price limits
[![Yahoo Stock Ticker Screenshot 2][yahoo-stock-ticker-2]](https://github.com/longpdo/bitbar-plugins-custom/blob/master/plugins/yahoo_stock_ticker.18m.py)
#### [Social Media Stats](https://getbitbar.com/plugins/Web/Instagram/social_media_stats.1h.py)
Dependencies: Python3, beautifulsoup4, requests
* Shows YouTube subscribers, Facebook likes and Instagram followers.
[![Social Media Stats Screenshot][social-media-stats-screenshot]](https://github.com/longpdo/bitbar-plugins-custom/blob/master/plugins/yahoo-weather.1h.py)
## Getting Started
To get a local copy up and running follow these simple steps.
### Prerequisites
* BitBar
```sh
# Install via brew on macOS
brew cask install bitbar
```
Or download .app file directly: [Get the latest version of BitBar](https://github.com/matryer/bitbar/releases). Then copy it to your Applications folder.
### Installation
1: Fork the repository (using the `Fork` button at the top)
2: Clone the repository
```sh
# Replace {YOUR_USERNAME} with your actual username
git clone https://github.com/{YOUR_USERNAME}/bitbar-plugins-custom.git
```
3: Change directory to bitbar-plugins-custom
```sh
cd bitbar-plugins-custom
```
4: Install python requirements
```sh
pip3 install -r requirements.txt
```
## Usage
Run BitBar.app - it will ask you to select a plugins folder, choose the `bitbar-plugins-custom/plugins` folder
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Acknowledgements
* [BitBar](https://github.com/matryer/bitbar)
* [BitBar Plugins](https://github.com/matryer/bitbar-plugins)
[product-screenshot]: images/screenshot.png
[calendarlite-screenshot]: images/CalendarLite.png
[social-media-stats-screenshot]: images/social_media_stats.gif
[yahoo-stock-ticker]: images/yahoo-stock-ticker.gif
[yahoo-stock-ticker-2]: images/yahoo-stock-ticker-2.gif
[yahoo-weather-screenshot]: images/yahoo-weather.png