https://github.com/refi64/howl-flatpak
Build and run applications in their Flatpaks from within Howl
https://github.com/refi64/howl-flatpak
Last synced: 4 months ago
JSON representation
Build and run applications in their Flatpaks from within Howl
- Host: GitHub
- URL: https://github.com/refi64/howl-flatpak
- Owner: refi64
- License: mit
- Created: 2018-05-18T22:19:26.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-05-18T22:19:35.000Z (about 8 years ago)
- Last Synced: 2025-03-25T05:06:46.236Z (about 1 year ago)
- Language: MoonScript
- Size: 2.93 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# howl-flatpak
howl-flatpak provides two commands for building and running Flatpaks inside of Howl:
`flatpak-build` (bound to `ctrl_alt_f`) and `flatpak-build-run`
(bound to `ctrl_shift_alt_f`).
**Please read this before trying out the bundle!**
## Basics
`flatpak-build` builds a Flatpak, and `flatpak-build-run` builds and then runs it.
(Shocking, I know.) The manifest file will be automatically located; you can override
it via the `flatpak_manifest` config variable. When flatpak-builder is run, it will
use `flatpak_builder_directory` as its build directory; the default is flatpak-app.
## Source replacement
Imagine this scenario: you're working on your application, and there's a Flatpak
manifest *inside your Git repository*. Now, when you build the Flatpak, you probably want
to use your current source tree, *not* the version that your flatpak-builder manifest is
using. GNOME Builder handles this automatically, and so does howl-flatpak.
Some notes:
- Your project root *must* be a Git repository.
- In your Flatpak manifest, the module corresponding to your project *must* download
your project's sources from Git. Any other sources can be from any other location,
but this one must be your *only* Git source.
- howl-flatpak needs to know the name of the module corresponding to your project. By
default, this will be inferred as your project's root directory basename. (AFAIK
GNOME Builder does this, too.) If you want to change it, set `flatpak_module` to
your module name.
If you want to disable this behavior (for instance, if your manifest is in a separate
repository), set `flatpak_source` to `false`.