Skip to content

emendir/QR-ScanGen

Repository files navigation

<style>img { width: 100%;}</style>

QR ScanGen

A simple cross-platform QR code scanner and generator.

Easy and fast to use, no buttons except to switch cameras. Scanned QR codes are automatically copied to clipboard, open websites & connect to WiFi networks.

Written in Python, using the Qt GUI framework.

Features

  • scan and decode QR-code from camera to text
  • encode text to QR-code
  • scanning actions for recognised content:
    • auto-copy to clipboard
    • auto-open URLs in default browser
    • auto-connect to WiFi networks (Linux tested, Windows 10 tested, MacOS untested)
  • save QR-code image to file (click on it)
  • no unnecessary click-work for user, all features in one simple page

Download and Installation

Head over to the releases page to download compiled binaries. I maintain packages for:

Linux:

  • AppImage (x86-64) (fully featured)
  • flatpak (x86-64, aarch64) (no clipboard, and WiFi connection only after running: flatpak override --user --socket=system-bus tech.emendir.QR-ScanGen)
  • Pip:
# prerequisites
sudo apt install -y python3-zbar

# install app
pip install qr-scangen

# run app:
qr-scangen

# if the above fails, use:
python -m qr_scangen

Windows:

# install app
pip install qr-scangen

# run app:
qr-scangen

# if the above fails, use:
python -m qr_scangen

MacOS:

  • Pip (untested - try this):
# install app
pip install qr-scangen

# run app:
qr-scangen

# if the above fails, use:
python -m qr_scangen

If no packages are available for your OS, see the section below on how to run this project from source.

Run from source:

  1. Prerequisites: You need Python3 and a library manager for it (such as pip) installed on your computer.
  2. Download this project and navigate to its folder:
git clone https://github.com/emendir/QR-ScanGen
cd ScanGen
  1. Install the necessary python libraries:
pip3 install requirements.txt
  1. Run the project:
python3 .

You may need to replace pip3 with pip and python3 with python depending on your environment.

Build from source:

  1. perform all the steps in the Run from source section above
  2. install pyinstaller with:
    pip3 install pyinstaller
    (you may need to replace pip3 with pip depending on your environment)
  3. run the build.py script with
    python3 build.py
  4. The executable binary for your computer's operating system and computer architecture will be located in the dist folder.

Contributing

Get Involved

  • GitHub Discussions: if you want to share ideas
  • GitHub Issues: if you find bugs, other issues, or would like to submit feature requests
  • GitHub Merge Requests: if you think you know what you're doing, you're very welcome!

Donations

To support me in my work on this and other projects, you can make donations with the following currencies:

Donations help me:

  • dedicate more time to developing and maintaining open-source projects
  • cover costs for IT infrastructure
  • finance projects requiring additional hardware & compute

About the Developer

This project is developed by a human one-man team, publishing under the name Emendir.
I build open technologies trying to improve our world; learning, working and sharing under the principle:

Freely I have received, freely I give.

Feel welcome to join in with code contributions, discussions, ideas and more!

Open-Source in the Public Domain

I dedicate this project to the public domain. It is open source and free to use, share, modify, and build upon without restrictions or conditions.

I make no patent or trademark claims over this project.

Formally, you may use this project under either the:

Links

This project's IPFS URL:
ipns://k2k4r8nismm5mmgrox2fci816xvj4l4cudnuc55gkfoealjuiaexbsup#QR-ScanGen

About

easy and practical QR-code scanner and generator

Resources

License

MIT-0, CC0-1.0 licenses found

Licenses found

MIT-0
LICENSE
CC0-1.0
LICENSE-CC0

Stars

Watchers

Forks

Packages

No packages published