From 0916fc3cf6314b3b9a96d871314f3bca02d80d8e Mon Sep 17 00:00:00 2001 From: Felitendo Date: Thu, 24 Sep 2026 02:00:39 +0200 Subject: [PATCH] docs: cut the readme down, fold the details --- README.md | 110 +++++++++++++++++++++++++++--------------------------- 1 file changed, 55 insertions(+), 55 deletions(-) diff --git a/README.md b/README.md index 2bb00c2..5e5ab2a 100644 --- a/README.md +++ b/README.md @@ -4,15 +4,15 @@

bottles-opener

-

Double-click a file and it opens in its Windows program, inside its bottle.

+

Double-click a file and it opens in its Windows program.

- Works with FL Studio, Microsoft Office, Photoshop, Ableton and anything else you run through Bottles. + FL Studio, Office, Photoshop, Ableton and anything else you run in Bottles.

+ Install | How to use | - Install | Report a bug
@@ -20,89 +20,89 @@ Buy Me A Coffee

-You install FL Studio in Bottles, double-click your `.flp` and... your file manager asks what an `.flp` is. This tool reads which files your Windows programs registered in their bottle. That is the same list Windows uses. It teaches your system those types, gives them the program's icons and hands the file over the way Explorer would. One command and your files _✨just open✨_ (like on windows). +## Install + +```bash +yay -S bottles-opener +``` + +Needs `python3` with PyYAML and icoextract. Bottles needs both too. ## How to use -Just run `bottles-opener`: +```bash +bottles-opener +```

The bottles-opener menu in Konsole: file opening on, 5 programs in 3 bottles

-Press `[1]` and you're done. `[3]` lists every file type and lets you pick what opens it: +Press **1**. Your files _✨just open✨_ in their program, like on Windows. + +
+File types + +**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) |

The file types list in Konsole: .flp opens in FL Studio on a double-click, Office types are under Open With

-`double-click` opens it. `Open With` only lists it in the right-click menu. Types that already have an app on your system get this (like `.docx` with LibreOffice), so nothing you picked gets taken away. Space switches. +Your own file types: `bottles-opener add flp,fst "FL Studio"` -`[4]` lists your programs; Enter edits their file types, so you can add any extension you like. Or without the menu: +
-```bash -bottles-opener add flp,fst "FL Studio" -``` +## More -## How to install +
+How it works -**Arch** - -```bash -yay -S bottles-opener -bottles-opener enable -``` - -**From source** - -```bash -make -sudo make install -bottles-opener enable -``` - -No root? `make install PREFIX=~/.local` works too. - -Needs `bash`, `python3` with PyYAML and icoextract (Bottles needs both itself) and `update-mime-database`. - -## Features - -- **Which files:** read from the bottle's registry, like Windows does (`.flp` → `FL64.flp.26` → `FL64.exe "%1"`). Programs that registered nothing are matched against a built-in list: all of Office, FL Studio, Ableton, Cubase, Photoshop, Illustrator, Affinity, AutoCAD, SketchUp and more. -- **Unknown extensions** (`.flp`, `.msg`, `.als`, ...) get a MIME type in `~/.local/share/mime/packages/bottles-opener.xml`, named like in Windows ("FL Studio project file"). Where Linux means something else by an extension (`.mpp` is Musepack, `.fst` a tracker module) the file's signature tells them apart. -- **Icons:** the file gets the icon Windows shows, pulled out of the program. A type your system already knows keeps its icon until the program is its default. -- **Opening:** the path becomes the Windows path (`Z:\home\you\song.flp`), with the switches from the registry (Outlook `/f`, PowerPoint shows `/s`), started through `bottles-cli` with all your bottle's settings. -- **Flatpak Bottles:** the file goes through the document portal first, like `flatpak run --file-forwarding`. - -Everything written is recorded, so `bottles-opener disable` puts back exactly what was there. New programs are picked up by a systemd path unit; `bottles-opener apply` does the same by hand. - -## Why not just Bottles? - -Bottles 67 has "File Associations" per program, but it rejects extensions your system doesn't know (so `.flp`, `.msg`, `.als` are "invalid"), passes Linux paths, doesn't know which program opens what and doesn't touch icons. - -## Commands - -| Command | | +| | | |---|---| -| `bottles-opener` | Interactive menu | -| `… enable` | Turn on, apply, start watching | +| 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. + +
+ +
+Commands + +| | | +|---|---| +| `bottles-opener` | The menu | +| `… enable` | Turn on | | `… disable` | Undo everything | | `… apply` | Pick up new programs | -| `… apply --rebuild` | Redo from scratch | -| `… status` | What's set up | +| `… status` | What is set up | | `… list` | All file types and what opens them | | `… programs` | All programs and their file types | | `… add [bottle]` | Open file types with a program | | `… remove [program]` | Stop opening file types | -## Building from source +
+ +
+Build from source ```bash make sudo make install +bottles-opener enable ``` -Optionally needs `msgfmt` (gettext) and `scdoc`. Supports `PREFIX` and `DESTDIR`. `make check` runs syntax checks and shellcheck. +`make install PREFIX=~/.local` works without root. -## License +
GPL-3.0-or-later.