nativefier / nativefier-icons Goto Github PK

View Code? Open in Web Editor NEW

195.0 195.0 95.0 18.3 MB

Server and Icon Repository for Nativefier

Home Page: http://nativefier.github.io/nativefier-icons

Ruby 0.59% HTML 8.30% Shell 91.11%

nativefier-icons's Introduction

Note: Nativefier is unmaintained, please see #1577.

Nativefier

You want to make a native-looking wrapper for WhatsApp Web (or any web page).

nativefier 'web.whatsapp.com'

You're done.

Introduction

Nativefier is a command-line tool to easily create a “desktop app” for any web site with minimal fuss. Apps are wrapped by Electron (which uses Chromium under the hood) in an OS executable (.app, .exe, etc) usable on Windows, macOS and Linux.

I built this because I grew tired of having to Alt-Tab to my browser and then search through numerous open tabs when using Messenger or Whatsapp Web (HN thread). Nativefier features:

Automatically retrieval of app icon / name
Injection of custom JS & CSS
Many more, see the API docs or nativefier --help

Installation

Install Nativefier globally with npm install -g nativefier . Requirements:

macOS 10.13+ / Windows / Linux
Node.js ≥ 16.9 and npm ≥ 7.10

Optional dependencies:

ImageMagick or GraphicsMagick to convert icons. Be sure convert + identify or gm are in your $PATH.
Wine to build Windows apps from non-Windows platforms. Be sure wine is in your $PATH.

Or install with Docker (click to expand)

Pull the image from Docker Hub: docker pull nativefier/nativefier
... or build it yourself: docker build -t local/nativefier . (in this case, replace nativefier/ in the below examples with local/)

By default, nativefier --help will be executed. To build e.g. a Gmail app into ~/nativefier-apps,

docker run --rm -v ~/nativefier-apps:/target/ nativefier/nativefier https://mail.google.com/ /target/

You can pass Nativefier flags, and mount volumes to pass local files. E.g. to use an icon,

docker run --rm -v ~/my-icons-folder/:/src -v $TARGET-PATH:/target nativefier/nativefier --icon /src/icon.png --name whatsApp -p linux -a x64 https://web.whatsapp.com/ /target/

Or install with Snap & AUR (click to expand)

These repos are not managed by Nativefier maintainers; use at your own risk. If using them, for your security, please inspect the build script.

Snap
AUR

Usage

To create an app for medium.com, simply nativefier 'medium.com'

Nativefier will try to determine the app name, and well as other options that you can override. For example, to override the name, nativefier --name 'My Medium App' 'medium.com'

Read the API docs or run nativefier --help to learn about command-line flags and configure your app.

Troubleshooting

See CATALOG.md for site-specific ideas & workarounds contributed by the community.

If this doesn’t help, go look at our issue tracker.

Development

Help welcome on bugs and feature requests!

Docs: Developer / build / hacking, API / flags, Changelog.

License: MIT.

nativefier-icons's People

Contributors

Stargazers

Watchers

Forkers

rockingtits pascalwhoop swrobel ericsaboia denisbr elfassy austencm focusaurus ejjoo codebucketdev bogdan-kulynych mattiaaccornero vaginessa ialexryan tldr69 th0m4s jherrm khaltis derekperkins egmontsong whtsky kingmob brunolemos crazyants nicolasgeraud jeandat electronapps lucaszapico prarabdh31 matanrubin mvhenten dtateii dennyhollick alexanderpepper nanpuhaha rodrigoflores isc-labs ma5onic sconetto znd4 isaac-martin satowallet chipper1 codetree pierreguilmin kore-development littledivy firesidegargoyle vaporfan heliostatic dsernst krystof-k rodi01 rehman-00001 ktryndchrs lsh1023 bastiotutuama cruciformhawk7 nghoapc vishweshs4 laurentfough digisavvy hafeez3000 vivicai chase9 helinskii peterg79 primeminister cseelus coreyvidal discoveryov joanroig nick-seward adekmaulana itai-nelken jiahaog sarweshparajuli therakeshpurohit talmax1124 rickylss espositoandrea bennihtm kshupa brayman30 turnipjs gnumber13 lostcrew alexrogalskiy odeilson-cod productinfo pombredanne lixuannan motte

nativefier-icons's Issues

Is this project still maintained?

I've had a PR submitted for over a month now, and I see some that are older. I have many more contributions I'm eager to make, but not if my pull requests are ignored.

Open links in default browser by default

Hi, I'm wondering, is there a way to define the behavior for links.

Indeed, I'm using nativefier for gmail/inbox and I'm a bit tired notably with a trackpad to use the second click to open links in my default browser.

The current default behavior is to open a new window inside nativefier which of course doesn't share cookies, …

Thanks :)

Application to join nativefier-icons maintainer team

Details

User: github.com/PhantomNimbi
Team: github.com/DeveCorner-Github
Support Request: Application to join nativefier-icons maintainer team
Details:

I'm noticing this repo has become largely unmaintained and would like to offer to help maintain it if it would be something the nativefier team is willing to allow.

If accepted, I can check for new pull requests occasionally and even set up push notifications to notify me of new pull requests so I can keep on top of it, as well as anything else that may be asked of me.

As it stands I have plenty of free time and would be plenty capable of helping to keep the icon-repo maintained if the team is willing to allow.

If you are up for accepting a new maintainer I'm free to help. You can contact me via Discord and also via a response to this page if it is faster.

Contact Information

Discord Tag: Nimbi#4961
Discord Server: discord.me/developer-corner