Skip to content

zrnge/doc-reader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

📄 Document Reader

A lightweight Python GUI application for reading .docx and legacy .doc files. Built with tkinter — no heavy frameworks required.

Python License Platform


Features

  • Open and read .docx and .doc files through a clean dark-themed GUI
  • Threaded file loading — UI stays responsive on large documents
  • Word and line count displayed in the status bar
  • Keyboard shortcuts (Ctrl+O to open, Ctrl+Q to quit)
  • Fallback chain for legacy .doc support (antiword → LibreOffice)

Screenshots

screenshot

Prerequisites

  • Python 3.7 or higher
  • tkinter (included with most Python installations)

Installation

  1. Clone the repository:

    git clone https://github.com/zrnge/doc-reader.git
    cd doc-reader
  2. Install Python dependencies:

    pip install python-docx
  3. (Optional) For legacy .doc file support, install one of the following:

    Linux:

    sudo apt install antiword

    Windows / macOS:

    Install LibreOffice and make sure it is available in your system PATH.

Usage

python doc_reader.py

Click Open File (or press Ctrl+O) and select a .docx or .doc file. The content will be displayed in the text area.

Keyboard Shortcuts

Shortcut Action
Ctrl + O Open file
Ctrl + Q Quit app

Project Structure

document-reader/
├── doc_reader.py   # Main application
├── README.md
└── LICENSE

How It Works

Format Method
.docx Parsed with python-docx
.doc Extracted via antiword CLI, with LibreOffice headless as a fallback

Contributing

Contributions are welcome. Fork the repo, create a branch, and open a pull request.

License

This project is licensed under the MIT License. See LICENSE for details.

About

A lightweight Python GUI application for reading .docx and legacy .doc files

Topics

Resources

License

Stars

Watchers

Forks

Languages