nativefier/CATALOG.md

Build Commands Catalog

Below you'll find a list of build commands contributed by the Nativefier community. They are here as examples, to help you nativefy "complicated" apps that need a bit of elbow grease to work. We need your help to enrich it, as long as you follow these two guidelines:

1. Only add sites that require something special! No need to document here that simplesite.com works with a simple nativefier simplesite.com 🙂.
2. Please add commands with the strict necessary to make an app work. For example,
   • Yes to mention that --widevine or some --browserwindow-options are necessary...
   • ... but don't add other flags that are pure personal preference (e.g. --disable-dev-tools or --disk-cache-size).

---

Google apps

(This example documents Google Sheets, but is applicable to other Google apps)

nativefier 'https://docs.google.com/spreadsheets' \
  --user-agent firefox

Note: lying about the User Agent is required, else Google will notice your "Chrome" isn't a real Chrome, and will refuse access.

Outlook

nativefier 'https://outlook.office.com/mail'
  --internal-urls '.*?(outlook.live.com|outlook.office365.com).*?'
  --file-download-options '{"saveAs": true}'
  --browserwindow-options '{"webPreferences": { "webviewTag": true, "nodeIntegration": true, "nodeIntegrationInSubFrames": true, "nativeWindowOpen": true } }'

Note: --browserwindow-options is needed to allow pop-outs when creating/editing an email.

Udemy

nativefier 'https://www.udemy.com/'
  --internal-urls '.*?udemy.*?'
  --file-download-options '{"saveAs": true}'
  --widevine

Note: most videos will work, but to play some DRMed videos you must pass --widevine AND sign the app.

HBO Max

nativefier 'https://play.hbomax.com/'
  --widevine
  --enable-es3-apis
&& python -m castlabs_evs.vmp sign-pkg 'name_of_the_generated_hbo_app'

Note: as for Udemy, --widevine + app signing is necessary.

Spotify

nativefier 'https://open.spotify.com/'
  --widevine
  --user-agent firefox
  --inject spotify.js
  --inject spotify.css

Notes:

• Inject the following javascript as spotify.js to prevent "Unsupported Browser" messages.

function dontShowBrowserNoticePage() {
    const browserNotice = document.getElementById('browser-support-notice');
    console.log({ browserNotice })
    if (browserNotice) {
        // When Spotify displays the browser notice, it's not just the notice,
        // but the entire page is focused on not allowing you to proceed.
        // So in this case, we hide the body element (so nothing shows)
        // until our JS deletes the service worker and reload (which will actually load the player)
        document.getElementsByTagName('body')[0].style.display = 'none';
    }
}

function reload() {
    window.location.href = window.location.href;
}

function nukeWorkers() {
    dontShowBrowserNoticePage();
    if ('serviceWorker' in navigator) {
        caches.keys().then(function (cacheNames) {
            cacheNames.forEach(function (cacheName) {
                console.debug('Deleting cache', cacheName);
                caches.delete(cacheName);
            });
        });
        navigator.serviceWorker.getRegistrations().then((registrations) => {
            registrations.forEach((worker) =>
                worker.unregister().then((u) => {
                    console.debug('Unregistered worker', worker);
                    reload();
                }).catch((e) =>
                    console.error('Unable to unregister worker', error, { worker })
                )
            );
        });
    }
}

document.addEventListener('DOMContentLoaded', () => {
    nukeWorkers()
});

if (document.readyState === "interactive") {
    nukeWorkers();
}

• It is also required to sign the app, or many songs will not play.
• To hide all download links (as if you were in the actual app), inject the following CSS as spotify.css:

a[href="/download"] { display: none; }