README.md

📃 About

A simple MacOS menu bar app to display current coins from most popular Liquidity Pools on TinyMan.org 🤖

⚠️ NOTE: This is a pre-release version, utility is under active development.

---

Prerequisites

• python 3.9.x
• poetry
• pre-commit

🚀 Quick start

If you are looking for quick executable installation refer to links below:

• MacOS latest

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

git clone https://github.com/aorumbayev/tinybar

2. Install python requirements

poetry install # install all dependencies
poetry shell # activate virtual env

3. Configure pre-commit hooks

pre-commit install

4. Run tinybar in dev mode

(.venv) PYTHONPATH="." python src/tinybar.py

5. (optional) Build app executable

(.venv) PYTHONPATH="." python3 setup.py py2app

🧪 Testing

TBD

🙋‍♂️ Contribution guideline

TBD

⭐️ Stargazers

Special thanks to everyone who forked or starred the repository ❤️