jyapayne/Electrify
1
0
Fork 0
Code Issues 8 Pull requests Projects Releases 2 Packages Wiki Activity Actions

Electrify renaming.

Browse source
This commit is contained in:
Joey Payne 2016-02-08 09:49:06 -07:00
commit e8a8bfed9a
18 changed files with 115 additions and 182 deletions
Download patch file Download diff file Expand all files Collapse all files

63
README.md
View file

@ -1,44 +1,20 @@
Web2Executable
Electrify
==============
[Releases (Downloads)](https://github.com/jyapayne/Web2Executable/releases) (new!)
[Releases (Downloads)](https://github.com/jyapayne/Electrify/releases)
What is it?
-----------
Web2Executable is a friendly command line and GUI application that can transform your Nodejs (or any other JS/HTML) app into a standalone executable. It can export to Mac OS X, Windows and Linux all from one platform, so no need to go out and buy expensive hardware.
From the creator of [Electrifycutable](https://github.com/jyapayne/Electrifycutable) comes Electrify, another friendly command line and GUI application that can transform your Nodejs (or any other JS/HTML) app into a standalone executable. The difference is that it is now powered by [Electron](https://github.com/atom/electron) instead of NW.js. It can export to Mac OS X, Windows and Linux all from one platform, so no need to go out and buy expensive hardware.
It's powered by the very awesome project [NWJS](https://github.com/nwjs) and PySide, is open source, and is just dang awesome and easy to use.
It's powered by the very awesome project [Electron](https://github.com/atom/electron) and PySide, is open source, and is just dang awesome and easy to use.
If you have an idea for a feature, please create a new issue with a format like this: "Feature - My Awesome New Feature", along with a good description of what you'd like the feature to do.
If you got some value out of using my app, consider donating a dollar to keep me caffeinated :)
<a href='https://pledgie.com/campaigns/26899'><img alt='Click here to lend your support to: Web2Executable Donations and make a donation at pledgie.com !' src='https://pledgie.com/campaigns/26899.png?skin_name=chrome' border='0' ></a>
On the other hand, if you have any annoyances with the application and want to contribute to making it better for everyone, please file an issue with "Annoyance:" as the first part of the title. Sometimes it's hard to know what is annoying for people and input is much appreciated :)
Who's Using It?
---------------
Lots of people! There are currently thousands of downloads and several articles written about using Web2Executable.
Some articles include:
[Getting a Phaser Game on Steam](http://phaser.io/news/2015/10/getting-a-phaser-game-on-steam)
[Packt Publishing NW.js Essentials Tutorial](https://www.packtpub.com/packtlib/book/Web-Development/9781785280863/7/ch07lvl1sec53/Web2Executable) and [Ebook](https://books.google.ca/books?id=wz6qCQAAQBAJ&pg=PA135&lpg=PA135&dq=web2executable&source=bl&ots=sPP-3BOMXX&sig=UolyF31WcTgA-lrel2UTIfzs65U&hl=en&sa=X&redir_esc=y#v=onepage&q=web2executable&f=false)
[A Russian NW.js Tutoral](http://canonium.com/articles/nwjs-web-to-executable)
[Marv's Blog](http://www.marv.ph/tag/web2exe/)
[Shotten.com Node-webkit for Poets](http://www.shotton.com/wp/2014/10/27/node-webkit-for-poets-mac-version/)
If you have a project you'd like to see listed here that was successfully built using Web2Executable or you have written an article that mentions it, feel free to send me an email with a link and I'd be super stoked to paste it here :)
Features
--------
@ -49,24 +25,17 @@ Features
- Same performance as Google Chrome
- Works with Phaser; should work with other HTML5 game libraries
- Export web applications to all platforms from your current OS
- Ability to specify a node-webkit version to download
- Ability to specify an Electron version to download
- Automatic insertion of icon files into Windows exe's or Mac Apps by filling out the icon fields as necessary
- A command line utility with functionality equivalent to the GUI. Useful for automated builds.
- Compression of executables with upx
Planned New Features
--------------------
- The ability to add external files to the project
- Minifying JS and HTML
Getting Started
---------------
###Using Prebuilt Binaries
When using the prebuilt binaries for Windows, Mac, or Ubuntu, there are NO dependencies or extra applications needed. Simply download Web2Exe for the platform of your choice, extract, and double click the app/exe/binary to start. This applies to both the command-line version and the GUI version.
When using the prebuilt binaries for Windows, Mac, or Ubuntu, there are NO dependencies or extra applications needed. Simply download Electrify for the platform of your choice, extract, and double click the app/exe/binary to start. This applies to both the command-line version and the GUI version.
**NOTE!**: Some people report needing the Microsoft Visual C++ 2008/2010 SP1 and regular Redistributable package. I don't have a machine to test this, but just know that you might need the package if the application won't open or spits out the following error:
@ -77,11 +46,15 @@ Error: The application has failed to start because the side by side configuratio
### Run from Python Source
Requires the pyside library and python 2.X. If you want to replace the icon in the Windows Exe's, this will do it automatically with the latest code if you have PIL or Pillow installed. I've only tested the code on python 2.7.3-2.7.9, so I can't speak about any lower version, but it should work as long as PySide is supported.
Requires the pyside library and Python 3.4 or higher. If you want to replace the icon in the Windows Exe's, this will do it automatically with the latest code if you have PIL or Pillow installed.
####GUI
Install dependencies **PIL or Pillow** for icon and icns exporting.
Install dependencies:
```
pip install -r requirements.txt
```
Initiate submodules:
@ -92,7 +65,7 @@ git submodule update --init --recursive
Run with:
```
python main.py
python3.4 main.py
```
It's a pretty simple app. Just point it to the directory where your web application lives, customize the options (the two marked with a star are the only ones required) and then choose your export options. The app will export under YOUR_OUTPUT_DIR/YOUR_APP_NAME.
@ -106,12 +79,12 @@ Run the command_line.py with the --help option to see a list of export options.
Example usage (if using the prebuilt binary, replace `python command_line.py` with the exe name):
```
python command_line.py /var/www/html/CargoBlaster/ --main html/index.html --export-to linux-x64 windows mac --width 900 --height 700 --nw-version 0.10.5
python3.4 command_line.py /var/www/html/CargoBlaster/ --main html/index.html --export-to linux-x64 windows mac --width 900 --height 700 --electron-version 0.36.7
```
###GUI Instructions
To use Web2Exe:
To use Electrify:
1. Choose a project folder with at least one html or php file. The name of the export application will be autogenerated from the folder that you choose, so change it if you so desire.
2. Modify the options as needed.
3. Choose at least one export platform and then the Export button should enable (as long as the field names marked with a star are filled out and all files in the fields exist).
@ -122,14 +95,14 @@ To use Web2Exe:
If you have an issue, please check the FAQ before filing an issue to see if it helps.
[FAQ](https://github.com/jyapayne/Web2Executable/wiki/FAQ)
[FAQ](https://github.com/jyapayne/Electrify/wiki/FAQ)
### Additional Info
[Changelog](https://github.com/jyapayne/Web2Executable/wiki/Changelog)
[Changelog](https://github.com/jyapayne/Electrify/wiki/Changelog)
[Screenshots](https://github.com/jyapayne/Web2Executable/wiki/Screenshots)
[Screenshots](https://github.com/jyapayne/Electrify/wiki/Screenshots)
License