Skip to content

Desktop App to receive Images send via ImageShare Mobile App

License

Notifications You must be signed in to change notification settings

lagmoellertim/ImageShare-DesktopApp

Repository files navigation

UNMAINTAINED

Fork and use at your own risk. I rewrote the whole project to work in-browser as a webapp, which is called Glean. You can check it out here: glean.cloud

ImageShare Desktop App

With ImageShare, you can transfer photos from your mobile device wirelessly to your computer using the ImageShare Desktop App.

  • Easy connection to the Desktop App using a QR-Code
  • Take a picture or send an existing image from your gallery
  • Uses interactive, touch compatible UI for ease of use
  • Powered by the Chrome Embedded Framework and Flask

Intended Usecase

  • ImageShare is developed to work as a replacement of overhead projectors
  • You can run the ImageShare Desktop App on e.g. an interactive whiteboard to make full use out of the included features such as the integrated touch compatibility
  • Because of copy & paste functionality you can just move the received image to any picture or document editor of your liking

Mobile App

  • If you want to use this software, you may want to check out the corresponding mobile app to send images to this desktop app
  • The mobile app can be found at this repository: lagmoellertim/ImageShare-App

Tech

ImageShare uses a number of open source projects to work properly:

  • CEF Python - Chrome Embedded Framework for interactive Desktop UI
  • Flask - Web micro framework for easy connection between devices
  • PyInstaller - Freeze Python programs into stand-alone executables

So naturally, I also published ImageShare under the MIT License at my public repository on GitHub.

Installation

If you don't want to develop or test the app and just need the executable file, follow this link. If it doesn't work on the first try, check out the troubleshooting guide to hopefully fix your issue.

Otherwise, here is a short guide to setup the required environment to use the ImageShare Desktop-App on Windows. The ImageShare Desktop App requires Python 3.6 64-Bit (Direct download-link). After installing that version of Python, you can go on by typing in the commands below

git clone https://github.com/lagmoellertim/ImageShare-DesktopApp.git
cd ImageShare-DesktopApp/
pip install -r requirements.txt

To run the application, just type in the following command:

python main.py

Building the app on your own is as simple as doing the following:

python build.py

After building the app, you can get to it by using this command:

cd build_tools/dist/ImageShare/

To execute the build, type in

ImageShare.exe

Troubleshooting

If you can't get the app running, you may find the following guide helpful.

First of all, make sure you have the Microsoft Visual C++ Redistributable Package (vc_redist) installed on your computer. If this is not the case, you can download it from here.

If that didn't fix your problem, you should also allow the port 80 for incoming and outgoing connections in the windows firewall settings.

If you need any further advice or troubleshooting, feel free to open an Issue where you describe what was supposed to happen and what happend as detailed as possible. Also use command line output to make your problem clearer.

Dependencies

ImageShare is using numerous open-source Python dependencies, which are listed below.

Dependencies GitHub Repository
cefpython3 cztomczak/cefpython
flask pallets/flask
pyinstaller pyinstaller/pyinstaller
imdirect hbldh/imdirect
pillow python-pillow/Pillow
pyqrcode mnooner256/pyqrcode
pystray moses-palmer/pystray
pywin32 mhammond/pywin32

Donations / Sponsors

I'm part of the official GitHub Sponsors program where you can support me on a monthly basis.

GitHub Sponsors

You can also contribute by buying me a coffee (this is a one-time donation).

Ko-Fi Sponsors

Thank you for your support!

Todos

  • Bugfixes
  • Design modifications

License

MIT