Deprecated — no longer maintained. The public API endpoints this project relied on no longer exist in their original form. Texas DPS has changed its appointment scheduling system and API since this tool was written.
The latest commits were part of an effort to modernize the Python code and project setup. When that work reached HTTP testing, it became clear that the original API integration no longer worked. Adapting the project to the changed scheduling system is no longer worth maintaining, so development has stopped.
The documentation below describes the intended workflow as if the original API were still available. Setup instructions remain useful for exploring the code, but live appointment searches will no longer work.
fdmv is a personal Python tool for finding earlier Texas DPS driver license appointments across a wider area than the scheduling website's limited list of nearby offices.
The tool queries appointment availability for ZIP codes in a bundled dataset, calculates the distance from your home ZIP code, filters results by a chosen radius, removes duplicate records, and sorts appointments by date and distance. It saves the results to a JSON file for inspection. It searches for availability; it does not book appointments.
- Python 3.12 or newer
- uv for dependency management
- An internet connection for live appointment searches
The project uses requests for HTTP requests and geopy for distance
calculations. Both are installed during setup.
Clone the repository, open a terminal in its root directory, and install the project and its dependencies:
uv syncThis creates a local .venv and installs the fdmv command.
Alternatively, use an existing Python 3.12+ virtual environment with pip:
python -m pip install -e .Edit src/fdmv/cli.py before running the tool:
data = dmvttp.get_all_appointments(cache=False)
data = zipp.generate_distance_data(data, "75074", miles=50)- Replace
"75074"with your home ZIP code. - Change
miles=50to your desired search radius in miles. - Use
cache=Falseto fetch appointment availability and writecache.txt. - Use
cache=Trueto reuse an existingcache.txtwithout fetching availability again. A cached file must already exist in the directory where you run the tool.
These settings are configured in the source code; the command does not accept ZIP code or radius arguments. The distance calculation expects the returned appointment data to contain an entry for your home ZIP code.
From the repository root:
uv run fdmvIf you installed with pip, run fdmv from your activated virtual environment.
During a live search, the tool prints the ZIP code and HTTP status for each request. It then writes these files to the current working directory:
| File | Contents |
|---|---|
cache.txt |
Raw appointment records from the most recent live search, stored as JSON. |
appointments.json |
Filtered, deduplicated appointment records sorted by date and distance. |
Each result includes the location ID, address, appointment date, ZIP code,
latitude, longitude, and calculated distance in miles. Output dates use
YYYY/MM/DD format.
Reuse cached results when adjusting the ZIP code or radius to avoid repeating requests. Cached availability reflects the time it was fetched.
src/fdmv/
├── cli.py # Entry point and search configuration
├── dmvttp.py # Appointment API requests and caching
├── zipp.py # Distance calculation and radius filtering
├── sorter.py # Deduplication and appointment sorting
└── data/
└── 2014_Gaz_zcta_national.txt
The ZIP code reference file is bundled with the Python package and loaded using
importlib.resources, so it can be found regardless of the current working
directory. Despite its .txt extension, the bundled file contains JSON records.
No separate data download or manual placement is required.
This repository is retained for reference and personal experimentation. There are no plans to restore compatibility with the current scheduling system.