Metadata-Version: 2.4
Name: finnbar
Version: 0.2.0
Summary: FINNBAR – a TUI for checking IKEA product availability in your local store, straight from your terminal.
License: MIT
License-File: LICENSE
Author: fabieu
Author-email: 43068791+fabieu@users.noreply.github.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: textual (>=8.0.0,<9.0.0)
Description-Content-Type: text/markdown

# FINNBAR

**FINNBAR** - a TUI for browsing and checking real-time IKEA product availability across your local stores, without
leaving the terminal.

---

No more clicking through IKEA's website only to find your KALLAX is out of stock. **FINNBAR** (_finns bara_ — Swedish
for "is available") lets you search, filter, and check availability across multiple stores — all from the comfort of
your terminal.

## Features

- 🏪 **Browse stores** – list all IKEA stores for any supported country (40+ countries, 400+ stores)
- 📦 **Check stock** – look up real-time availability for one or more product IDs across all stores in a country
- ⌨️ **Keyboard-driven** – full keyboard navigation with shortcut bindings

## Requirements

- Python 3.11+

## Installation

```bash
# Download the latest release from PyPI
pipx install finnbar

# Launch the TUI
finnbar
```

## Screenshots

![FINNBAR idle state](docs/screenshot-idle.svg)

## Usage

| Keyboard shortcut | Action                                    |
|-------------------|-------------------------------------------|
| `Ctrl+K`          | Check stock for the entered product ID(s) |
| `Ctrl+X`          | Clear results                             |
| `Ctrl+Q`          | Quit                                      |

### Checking stock

1. Select a **country** from the dropdown
2. Optionally select a **store** from the dropdown (or leave it as "All stores")
3. Enter one or more **product IDs** in the input field (comma-separated, e.g. `306.043.67, 10606640`)
4. Press **Check Stock** or `Ctrl+K`

Built with [Textual](https://github.com/Textualize/textual) and powered by
the [ikea-availability-checker](https://github.com/Ephigenia/ikea-availability-checker) data.

