Files
bottles-opener/README.md
T
Felitendo da021305d9 chore: update readme
Removed unnecessary dependencies from the README.
2026-09-25 08:02:24 +02:00

107 lines
2.7 KiB
Markdown

<p align="center">
<img width="200" src="res/bottles-opener.svg" alt="bottles-opener">
</p>
<h1 align="center">bottles-opener</h1>
<h3 align="center">Double-click a file and it opens in its Windows program.</h3>
<p align="center">
FL Studio, Office, Photoshop, Ableton and anything else you run in <a href="https://usebottles.com">Bottles</a>.
</p>
<h5 align="center">
<a href="#install">Install</a> |
<a href="#how-to-use">How to use</a> |
<a href="https://github.com/LoonixTools/bottles-opener/issues">Report a bug</a>
</h5>
<p align="center">
<a href="https://ko-fi.com/felitendo"><img src="https://storage.ko-fi.com/cdn/kofi5.png?v=6" alt="Buy me a coffee on Ko-fi" height="48"></a>
</p>
## Install
```bash
yay -S bottles-opener
```
## How to use
```bash
bottles-opener
```
<p align="center">
<img src="res/screenshots/menu.png" alt="The bottles-opener menu in Konsole: file opening on, 5 programs in 3 bottles" width="620">
</p>
Press **1**. Your files _✨just open✨_ in their program, like on Windows.
<details>
<summary>File types</summary>
**3** lists every file type. Space switches between:
| | |
|---|---|
| double-click | Opens it in the program |
| Open With | Only listed in the right-click menu (when another app already opens it) |
<p align="center">
<img src="res/screenshots/file-types.png" alt="The file types list in Konsole: .flp opens in FL Studio on a double-click, Office types are under Open With" width="620">
</p>
Your own file types: `bottles-opener add flp,fst "FL Studio"`
</details>
## More
<details>
<summary>How it works</summary>
| | |
|---|---|
| File types | Read from the bottle's registry, like Windows does. Known programs without entries come from a built-in list. |
| Icons | The ones Windows shows, taken from the program. |
| Opening | With the Windows path and the program's own switches, through `bottles-cli`. |
| Undo | `bottles-opener disable` puts back exactly what was there. |
Bottles 67 has file associations too, but it refuses extensions your system does not know (like
`.flp`), passes Linux paths and leaves the icons alone.
</details>
<details>
<summary>Commands</summary>
| | |
|---|---|
| `bottles-opener` | The menu |
| `… enable` | Turn on |
| `… disable` | Undo everything |
| `… apply` | Pick up new programs |
| `… status` | What is set up |
| `… list` | All file types and what opens them |
| `… programs` | All programs and their file types |
| `… add <ext,...> <program> [bottle]` | Open file types with a program |
| `… remove <ext,...> [program]` | Stop opening file types |
</details>
<details>
<summary>Build from source</summary>
```bash
make
sudo make install
bottles-opener enable
```
`make install PREFIX=~/.local` works without root.
</details>
GPL-3.0-or-later.