README.md

Android Messages™ Desktop

Run Android Messages as a desktop app, a la iMessage. For those of us that prefer not to have a browser tab always open for this sort of thing.

Not affiliated with Google in any way. Android is a trademark of Google LLC.

Disclaimer: I have tested this with my Pixel on both macOS High Sierra nad Windows 10. Normal functionality seems to work, but help testing and feedback is greatly appreciated!

Inspired by:

• Google Play Music Desktop Player
• a Reddit post on r/Android

Based on:

• electron-boilerplate

Download

Head over to the latest releases page!

• For Mac, choose the dmg
• For Windows, choose the exe
• For Linux, choose either the deb, the snap, or the AppImage

Important note: The Windows app binary isn't signed. This doesn't seem to be a big problem, but please report any issues you run into on Windows that may be related to signing.

Important note 2: We currently have builds for Windows and macOS, and Linux. I've only tested on macOS and Windows 10, and would love help testing on Linux and older versions of Windows.

TODOs / Roadmap (rough order of priority):

• Make sure it actually works
• Release signed binaries for macOS (binaries are signed as of v0.0.2, done via 8492023)
• Make an icon (done via df625ba)
• Remove left-over code from electron-boilerplate
• Correct tests
• Release packages for Linux (done via 41ed205)
• Handling updates (done via 625bf6d)
• Platform-specific UX enhancements (i.e. badges in macOS dock)
• Release signed binaries for Windows
• Make a website? (if it gets popular enough)
• Support customization/custom options a la Google Play Music Desktop Player?

Development

Make sure you have Node.js installed, then run the following in your terminal:

git clone https://github.com/chrisknepper/android-messages-desktop.git
cd android-messages-desktop
npm install
npm start

Starting the app in development mode

npm start

Testing

Run all tests:

npm test

Unit

npm run unit

Using electron-mocha test runner with the Chai assertion library. You can put your spec files wherever you want within the src directory, just name them with the .spec.js extension.

End to end

npm run e2e

Using Mocha and Spectron. This task will run all files in e2e directory with .e2e.js extension.

Making a release

To package your app into an installer use command:

npm run release

Once the packaging process finished, the dist directory will contain your distributable file.

We use electron-builder to handle the packaging process. It has a lot of customization options, which you can declare under "build" key in package.json.

The icons

We use png2icons to create Windows and Mac icons from the source PNG icon, which is located in assets/android_messages_desktop_icon.png. However, the Windows icon generated from this package seems to result in visual corruption on Windows 10, so I'm manually converting the PNG to a Windows icon with icoconvert.com for the time being.