some wrappers around nativefier to generate sites and install them for you in Linux

2.5 KiB

Raw Blame History

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.