nozwock/votm

Voting manger developed and intended for School use

VOTM

A full-featured Voting Manager, Desktop App for School use.

This project was created to automate the time-consuming voting process that occurs annually in schools (at least in my school) for various positions, such as Student Council and Head Boy/Girl. Previously, this was done manually using a ballot box system, which required significant time and effort from the school staff to tally the results, often taking weeks. In contrast, VOTM (Voting Manager) offers efficient automation, providing results with ease. It holds a special place as my very first project. Yaya!

Report Bug · Request Feature

---

🖼️ Preview

📥 Download Binaries

Platform	Version	Links
Windows_x86	1.5.0	Download

📚 Usage

📄 Voting

If you've downloaded the release binary:

• Run the manage app for configurations (such as Candidate Names, Tokens generation, etc).
• Now, you may run the vote app to start a voting session.

Or if you've gotten it directly from source:

• you can run manage.py, via:

  python -m votm.manage or python manage.py

• and vote.py, via:

  python -m votm.vote or python vote.py

Note:	1. Default password is a blank field (i.e. ""). 2. Password/key are simply stored as sha256 hashes (not salted!).

⚙️ Configuration file

Configuration file is stored at these following paths-

• Windows: %USERPROFILE%\AppData\Local\nozwock\votm
• Linux: $HOME/.local/share/votm

😕 It Doesn't Work?

There are many possibilities on why it may not be working. You may not have the runtime requirements mentioned below installed (if you're doing it from source). Other than that some known reasons for issues you might've encountered might be:

• due to incompatibility between the dependencies & python version.
• due to incompatible version of python; This has been tested only on Python 3.7 & 3.10

🏗️ Get it from Source

1. Clone the repository, and checkout to ./votm:

git clone https://github.com/nozwock/votm.git
cd votm

📋 Runtime Requirements

2. To setup a virtual environment, do:

python -m venv venv
source venv/Scripts/activate

Note: It's venv/bin/activate on Linux/MacOS

3. To install prerequisites, do:

pip install .

Or you could just use poetry instead via:

poetry install

License

Licensed under GPLv3+.

votm's Issues

how to get password while start running manager.py

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop:

• OS: [e.g. Windows 64-bit]
• Version [e.g. 1.0.6]

Additional context
Add any other context about the problem here.