Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aorumbayev/tinybar
🔮 MacOS menu bar app to see prices of ASA pairs from Tinyman.org 👀
https://github.com/aorumbayev/tinybar
algorand algorand-standard-assets awesome-algorand macos macos-menubar python rumps tinyman
Last synced: 18 days ago
JSON representation
🔮 MacOS menu bar app to see prices of ASA pairs from Tinyman.org 👀
- Host: GitHub
- URL: https://github.com/aorumbayev/tinybar
- Owner: aorumbayev
- License: mit
- Created: 2022-01-01T22:58:47.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T01:54:22.000Z (about 2 months ago)
- Last Synced: 2024-11-16T06:30:34.048Z (27 days ago)
- Topics: algorand, algorand-standard-assets, awesome-algorand, macos, macos-menubar, python, rumps, tinyman
- Language: Python
- Homepage: https://tinybar.app
- Size: 277 KB
- Stars: 11
- Watchers: 3
- Forks: 2
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Mac-Menubar-Megalist - TinyBar
README
## 📃 About
A simple MacOS menu bar app to display current coins from most popular Liquidity Pools on [TinyMan.org](https://tinyman.org/) 🤖
_**⚠️ NOTE: This is a pre-release version, utility is under active development.**_
---
## Prerequisites
- [python 3.9.x](https://www.python.org/)
- [poetry](https://python-poetry.org/)
- [pre-commit](https://pre-commit.com/)
## 🚀 Quick start
If you are looking for quick executable installation refer to links below:
- [MacOS latest](https://github.com/aorumbayev/tinybar/releases/)
Afterwards, you can download latest `TinyBar.zip` file and move `*.app` file to `Applications` folder.
> Currently available on M1 Macs via Rosseta only.
> Additionally, note that the .app artifact is not signed, you need to navigate to `System Preferences` -> `Security & Privacy` -> `Click lock to make changes` -> allow `TinyBar.app` to run.
### Features
Be aware that by default the tool displays a `USDC` equivalent of `ALGO` after performing a swap between 1 `UNIT` of selected `ASA` and `ALGO`.
- ✅ - 5 Pairs available by default. _(Available)_
- ✅ - Add any Asset by ASA ID. _(Available)_
- ⚠️ - CI/CD _(Partially configured)_
- 🚧 - Custom base currency. _(only ALGO at the moment)_
- 🚧 - Code signed MacOS executables _(TBD)_
## ⚙️ Installation
_(for devs/contributors only )_
This section assumes that `poetry` and `pre-commit` are installed and executed from the root folder of this repository.
1. Clone the repo
```bash
git clone https://github.com/aorumbayev/tinybar
```
2. Install `python` requirements
```bash
poetry install # install all dependencies
poetry shell # activate virtual env
```
3. Configure `pre-commit` hooks
```bash
pre-commit install
```
4. Run tinybar in dev mode
```bash
(.venv) PYTHONPATH="." python src/tinybar.py
```
5. (optional) Build app executable
```bash
(.venv) PYTHONPATH="." python3 setup.py py2app
```
## 🧪 Testing
TBD
## 🙋♂️ Contribution guideline
TBD
## ⭐️ Stargazers
Special thanks to everyone who forked or starred the repository ❤️
[](https://github.com/aorumbayev/tinybar/stargazers)
[](https://github.com/aorumbayev/tinybar/network/members)