Uses node-webkit to generate "native" apps for already existing web apps.
Requires the pyside library and python 2.X to run. 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.5, so I can't speak about any lower version, but it should work as long as PySide is supported.
If you have an idea for a feature, please list it here.
If you got some value out of using my app, consider donating a dollar to keep me caffeinated :)
When building linux applications using this application, there is an issue on the newer versions of Ubuntu (13.XX) and similar distros that causes the error: Shared library libudev.so.0 does not exist. If you are distributing an application by exporting to these platforms, you'll need to instruct your users to either manually symlink the file or make an install script following the directions here. This is an issue with node-webkit and not this application itself.
Also, there was an issue for Mac with versions older that 0.1.8b where it wouldn't start up. Hopefully that is fixed now and you can enjoy the app!
###GUI
Install dependencies PIL or Pillow for icon and icns exporting.
Initiate submodules:
git submodule update --init --recursive
Run with:
python main.py
It's a pretty simple app. Just point it the the directory that 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.
###Command line interface
Dependencies: configobj (install with pip) and Pillow if you want icon replacement (not necessary)
Run the command_line.py with the --help option to see a list of export options. Optionally, if you don't want to install python, there are builds for Mac and Windows in the command_line_builds folder of this repository.
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
- Cross platform to Mac, Windows, Linux
- Working media out of the box (sound and video)
- Easy to use and straightforward
- Streamlined workflow from project -> working standalone exe
- 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
- 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 options using UPX to minimize the exe size
- Minification of javascript, html, css before zipping
The downloads folder is where Web2Exe stores the node-webkit versions in zip or tar format. This location should be chosen as a central location, because Web2Exe will reuse the files to create executables every time the export button is pressed. It will also save time by not having to redownload the node-webkit files over and over.
The Web2Executable/files/downloads folder is a good place to keep your downloads or any place that isn't your project's directory.
For right now, the default location is in Web2Executable/files/downloads (Web2Executable.app/Contents/MacOS/files/downloads for Mac OSX).
This location is stored on a by project basis, so it will load what you have set for a particular project from the package.json file. Right now, the only way to change it back to the default is to open the package.json file with a text editor and remove the download_dir option from it.
The icon replacement works by filling out the fields "Window Icon", "Exe Icon", or "Mac Icon". If "Window Icon" is filled out and the others aren't, Web2Exe will automatically use this field instead of "Exe Icon" or "Mac Icon" depending on if you export to Mac or Windows.
If you fill "Exe Icon" out, this will be used to replace the icon inside the node-webkit exe from the default compass icon if you export to Windows. Only pngs and jpegs are supported right now.
If you fill out "Mac Icon", this will convert the icon from png or jpeg to icns and copy it into the Mac app folder (or just copy if the icon is already in icns format). Of course, this is only when exporting to Mac.
Linux executables don't use icons, so there's nothing to replace. If you want to set an icon for when the app is running for Linux, simply fill out the "Window Icon" field.
v0.1.11b
- fixed a bug that overwrote the index.html path if it was not in the root directory
v0.1.10b
- added the ability to specify an icon for both mac and windows export applications
v0.1.9b
- made UI more compact for small screens
- fixed Mac issue with not loading! Yay!
v0.1.8b
- added an "Open to export folder" button that makes things a little easier to navigate to.
- attempted to fix Mac OS X issues with crashing
v0.1.7b
- added better download management so there is no redownloading things. Also a bunch of bugs were fixed up.
v0.1.6b
- added the ability to get newer NodeWebkit versions automatically from the changelog of node-webkit. Also fixed compatibility with 0.10.X.
v0.1.4b
- fixed an issue where index.html would be found with absolute path, which would cause a "require not found" error
v0.1.3b
- Added the ability to choose node-webkit versions if 0.9.2 is not what you want*
- Modified the UI slightly for people with smaller monitors
- Added a force-download option to overwrite files
*Note: If you have already downloaded, say, 0.9.2 of webkit, then you select 0.8.5, you will have to select "Force download" in order to update the files properly. I'm not sure how to reliably/efficiently detect and store multiple versions of the node-webkit files.
v0.1.2b
- Fixed an issue with icon copying
- Fixed a bug that overwrote existing package.json files.
###CMD
###GUI
####Mac OS X
Mac OS X 10.7+ download - v0.1.11b
Previous Versions:
Mac OS X 10.7+ download - v0.1.10b
Mac OS X 10.7+ download - v0.1.9b
Mac OS X 10.7+ download - v0.1.8b
You can just put the app where ever you want and double click to run it.
####Windows
Windows 7+ download - v0.1.11b
Previous Version:
Windows 7+ download - v0.1.10b
Double click the Win2Exe.exe file inside the extracted folder.
####Linux
Only on Ubuntu 12.04. If someone knows how to make them on all linux distros, let me know. I'm using cx_Freeze to compile them to standalone apps. You must copy all .so.X.X files to either /usr/local/lib/ or /usr/lib/ for it to work.
Linux 64bit download - v0.1.7b
Previous Version:
Linux 64bit download - v0.1.6b
chmod 755 the main binary inside the extracted folder and then run by double clicking or ./main from the command line. Also, if you get shared library errors, you need to copy all the .so files into /usr/lib/ or /usr/local/lib/. Make sure you check to see if any libraries in /usr/lib/ conflict with the files first.
chmod 755 main
sudo cp *.so.* /usr/lib/
Note: For some reason, these linux binaries are not working correctly on vanilla systems. I'm looking into the issue and will update them when I figure out what is going on.
v0.1.9b Mac OS X
v0.1.8b
v0.1.3b
v0.1.2b