Item Stock Tracker

<Name TBD> (Item Stock Tracker) is a program designed to alert users when specific items from an online retailer are back in stock.

ItemStockTracker.mp4

Prerequisites

Make sure you have installed and followed all of the following prerequisites on your development machine:

• Python-- Download & Install Python 3.9
• Email-- Fill out the email address(gmail_user) and password(gmail_password) in SendEmail.py as the sender email
• pillow-- Download & Install Pillow for python with version>=8.3.0
• requests-- Download & Install Requests for python with version~=2.26.0
• beautifulsoup4-- Download & Install Beautifulsoup4 for python with version~=4.10.0
• lxml-- Download & Install lxml for Python with version~=4.6.3
• setuptools-- Download & Install setuptools for Python with version~=57.0.0
• sphinx-- Download & Install setuptools for Python with sphinx
• sphinx-rtd-theme-- Download & Install setuptools for Python with sphinx-rtd-theme

Documentation

Item Stock Tracker’s documentation

Installation

1. Download the project from GitHub or clone the repository.

git clone https://github.com/qchen59/ItemStockTracker.git

2. Change the current directory to the project folder, install the required packages.

cd ItemStockTracker

pip install -r requirements.txt

3. Change the current directory to code, then run the GUI.py.

cd code

python3 GUI.py

Usage

By default, the GUI will already contain some data, which is loaded from data/tracker.txt. To add your own items, click the plus button in the upper right. You will be prompted to enter a name for the item you are tracking, along with a URL for a specific product page. Currently, amazon.com and bestbuy.com product pages are supported.

You can also edit, add, or delete items by right-clicking on a selected item:

When an item is restocked, a popup will appear. Optionally, an email alert will also be sent to a specified address.

Lastly, in the "Settings" tab you can adjust the refresh interval (how often the program will poll the website to check the stock status of your items), and configure your email alert settings.

Future Goals

• Come up with a good name！
• Text alert.
• Collect the in-stock drop data and predict the next drop time.
• More supported retailers.
• Other enhancements

Questions?

If you encountered any questions and seeking for helps, please contact the following emails. [email protected], [email protected]

Team Members

Qiuyu Chen

Yasitha Nisansala Rajapaksha

Hugh Wright

Jiacheng Yang