You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
88 lines
2.5 KiB
88 lines
2.5 KiB
# mknative
|
|
|
|
Some bash wrappers around nativefier to generate standalone electron apps and have them
|
|
installed as desktop apps.
|
|
|
|
```
|
|
mknative
|
|
========
|
|
Basic Usage: $ mknative [-u] -n NativeExample -s https://example.com
|
|
---------------------------------------------------------------------------
|
|
-n NativeExample installed application name (basically an id)
|
|
-s https://example.com website address
|
|
-u [optional] uninstall
|
|
-i example.com [optional] domain name to fetch favicon from.
|
|
-e '--extra-args' [optional] pass some extra args to nativefier build.
|
|
```
|
|
|
|
## Installation
|
|
|
|
dependencies:
|
|
|
|
- bash
|
|
- docker
|
|
- jq
|
|
- curl
|
|
- wget
|
|
|
|
```
|
|
make install
|
|
```
|
|
|
|
note: make sure `~/.local/bin` is in your `$PATH`
|
|
|
|
## Generating apps
|
|
|
|
```
|
|
mknative -n example-app -s https://example.com
|
|
```
|
|
|
|
it will look for an example-app.png file in `~/.local/share/mknative/icons/`.
|
|
Just download the icon for the site and place it there before running.
|
|
|
|
If you supply the `-i` argument, it will reach out to the favicongrabber.com API and give
|
|
you a list of things that look like icons on the home page of the domain you specify and
|
|
save it to your icons folder for you.
|
|
|
|
Here's an example of how that looks for a Plex.tv app.
|
|
|
|
```
|
|
$ mknative -s https://app.plex.tv/desktop -n plex.with.parts -i plex.tv
|
|
|
|
mknative
|
|
========
|
|
URL: https://app.plex.tv/desktop
|
|
Name: plex.with.parts
|
|
Icon Domain: plex.tv
|
|
|
|
Fetching potential icons using favicongrabber.com API (retry if fails, flaky API )...
|
|
Here's the icons I found, which would you like?
|
|
0) https://www.plex.tv/wp-content/themes/plex/assets/img/favicons/favicon-32x32.png
|
|
1) https://www.plex.tv/wp-content/themes/plex/assets/img/favicons/favicon-16x16.png
|
|
2) https://www.plex.tv/wp-content/themes/plex/assets/img/favicons/apple-touch-icon-144x144.png
|
|
3) https://www.plex.tv/wp-content/themes/plex/assets/img/favicons/apple-touch-icon-152x152.png
|
|
4) https://www.plex.tv/wp-content/themes/plex/assets/img/favicons/mstile-144x144.png
|
|
|
|
Selection: 2
|
|
|
|
getting https://www.plex.tv/wp-content/themes/plex/assets/img/favicons/apple-touch-icon-144x144.png
|
|
|
|
...
|
|
|
|
```
|
|
|
|
Then check out your application launcher for example-app.
|
|
|
|
## Uninstalling apps
|
|
|
|
```
|
|
mknative -u -n $name
|
|
```
|
|
|
|
## Contributing
|
|
|
|
I'd like to know if it works for you, or if it's broken somehow.
|
|
|
|
I'm not looking to create a giant repository of icons, the official nativefier repo on
|
|
github has a ton of them for common sites. Please don't open issues and pull requests to
|
|
add them.
|
|
|