| files | ||
| pepy@19c8f08c61 | ||
| .gitmodules | ||
| build_mac.bash | ||
| build_windows.bat | ||
| icns_info.py | ||
| image_utils.py | ||
| main.py | ||
| png.py | ||
| pycns.py | ||
| README.md | ||
| utils.py | ||
Web2Executable
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 liked this project that I've committed many hours to, show whatever support you wish as a donation here:
Note!!
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!
Getting Started
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.
FAQ
What is the downloads folder for and where should I keep it?
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.
Where is the default downloads location and how can I change it back?
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.
What's New?
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.
Prebuilt Binaries
###Mac OS X
Mac OS X 10.7+ download - v0.1.9b
Previous Version:
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
Previous Version:
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.
Features
- Cross platform to Mac, Windows, Linux
- 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
Future Features
- A download manager! It's getting annoying downloading stuff over and over.
- Automatic replacement of icon files inside of Mac apps and Windows exes. Right now, the only way to have a custom Mac icon is to convert your image to .icns format and put it in the resources folder of the app. For windows, you have to use a utility like Resource Hacker.
Screenshots
v0.1.9b Mac OS X
v0.1.8b
v0.1.3b
v0.1.2b
