Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vladikoff/chromeos-apk
☢️ Run Android Apps in Chrome OS OR Chrome in OS X, Linux and Windows.
https://github.com/vladikoff/chromeos-apk
Last synced: 9 days ago
JSON representation
☢️ Run Android Apps in Chrome OS OR Chrome in OS X, Linux and Windows.
- Host: GitHub
- URL: https://github.com/vladikoff/chromeos-apk
- Owner: vladikoff
- License: mit
- Created: 2014-09-16T22:28:22.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2023-07-13T22:08:18.000Z (over 1 year ago)
- Last Synced: 2024-05-02T06:07:46.406Z (6 months ago)
- Language: JavaScript
- Homepage:
- Size: 93.8 KB
- Stars: 7,711
- Watchers: 402
- Forks: 926
- Open Issues: 212
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
- awesome - vladikoff/chromeos-apk - ☢️ Run Android Apps in Chrome OS OR Chrome in OS X, Linux and Windows. (JavaScript)
- my-awesome-github-stars - vladikoff/chromeos-apk - ☢️ Run Android Apps in Chrome OS OR Chrome in OS X, Linux and Windows. (JavaScript)
README
chromeos-apk
======================
> Run Android APKs on Chrome OS, OS X, Linux and Windows.
### Now supports OS X, Linux and Windows
>See the [Custom ARChon runtime guide](archon.md) to run apps on other operating systems besides Chrome OS.
### [Video Demo](https://www.youtube.com/watch?v=O-yFLqp_sXs)
## Quick Demo for Chrome OS
- Download an official app, [such as Evernote](https://chrome.google.com/webstore/detail/evernote/dhfolfjkgpeaojbiicgheljefkfbbfkc), from the Chrome Web Store.
- Then download this open source game: [2048.APK Game](https://github.com/vladikoff/chromeos-apk/releases/download/v1.1.0/com.uberspot.a2048.android-OFFICIAL.zip) by [Uberspot](https://github.com/uberspot/2048-android) and load it as an unpacked extension. Go to chrome://apps and launch it there, ignore warnings.
## Setup for Chrome OS / App Conversion
> Conversion Tool Tested on OS X, Windows and Ubuntu. You can also [convert APKs manually](manually-convert.md).
- Install [a sample Android app from the Chrome Store](https://chrome.google.com/webstore/detail/kids-sight-words/inpoiemibmljfjmjmlokfdllnkjejhai) to get the runtime. Test out that app, make sure it runs on your hardware.
- (Ubuntu might need `sudo apt-get install lib32stdc++6`)
- Install Node.js (via http://nodejs.org/)
- Install the tool (might need a `sudo` prefix):
```
npm install chromeos-apk -g
```
or
```
sudo npm install chromeos-apk -g
```
## Usage
Run
`chromeos-apk [path to apk file]`
### Example phone app
```
chromeos-apk com.soundcloud.android.apk
```
#### Example tablet app
```
chromeos-apk com.soundcloud.android.apk --tablet
```
This will generate a directory for you, i.e `com.soundcloud.android`. Copy this directory to your Chromebook.
On your Chromebook go to `chrome://extensions`, enable "Developer mode", and load the directory using the "Load unpacked extension" button.
## Troubleshooting
Make sure Android applications are compatible with your Chromebook, first try to install an official application such as Vine:
https://chrome.google.com/webstore/detail/vine/plfjlfohfjjpmmifkbcmalnmcebkklkh
If you get a `Failed to parse package name in the APK.` error, then you will have to type it the proper package name for the application. You can find out the package name by looking at the URL of the app in the Play Store.
## Note
**Chrome OS:** With Chrome 38+ you can now side load as many applications as you want. If you have older apps that
were created using `chromeos-apk` tool then re-convert them or remove the `"key"` option from `manifest.json`.
**Windows, Linux and OS X:** To load unlimited number of apps on you need a custom runtime, see the [ARChon runtime guide](archon.md) for details.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
## Tested Apps
Read [the manifest guide](manifest.md) to tweak applications. Android `Menu` key is accessible using `ctrl` + `ESC`.
- Flipboard, Flixster, Twitter - Works.
- Pandora - Works [[Screenshot](http://i.imgur.com/0d8XvXr.png)]
- Yahoo Screens, Weather and Mail work in Phone mode (might need to remove `gcm` from `usePlayServices` in `manifest.json`).
- Soundcloud - Works, crashes when playing sound.
- Chrome, Firefox, Opera, Spotify - Crashes (require native libraries).
- Opera Mini - Works, issues with the back button.
- [Gyro Game](https://play.google.com/store/apps/details?id=pl.submachine.gyro&hl=en) - Works
- [Break Bricks Game](https://play.google.com/store/apps/details?id=com.tongwei.blockbreaker) - Works
- Swing Copters - Crashes on Google Play Services.
- WhatsApp - Crashes
- IMDB - Works
- Skype `com.skype.raider` - Works, requires you to enter the package name manually in the CLI, use `com.skype.raider`. Use an older version of APK 5.0.0.x to get this to work.
- XBMC - Crash after initial load.
- Microsoft Remote Desktop - App seems to work properly after crashing once.
### Author
| [](https://twitter.com/vladikoff "Follow @vladikoff on Twitter") |
|---|
| [@vladikoff](https://twitter.com/vladikoff) |