2
2
mirror of https://github.com/Llewellynvdm/nativefier.git synced 2024-10-31 18:52:30 +00:00
nativefier/CATALOG.md

4.8 KiB

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.

WhatsApp

nativefier 'https://web.whatsapp.com/'
  --inject whatsapp.js

With this --inject in whatsapp.js (and maybe more, see #1112):

if ('serviceWorker' in navigator) {
  caches.keys().then(function (cacheNames) {
    cacheNames.forEach(function (cacheName) {
      caches.delete(cacheName);
    });
  });
}

Spotify

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

Notes:

  • You might have to pass --user-agent firefox to circumvent Spotify's detection that your browser isn't a real Chrome. But maybe not.
  • 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;
}