gitwtfhub

wtf is sheet-me?

deekshithvodela/sheet-me — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5Setup · easy

TL;DR

A Python command line tool that turns scanned or tilted PDF tables into clean, styled Excel spreadsheets using OCR.

Mindmap

mindmap
  root((sheet-me))
    What it does
      Straightens tilted scans
      Reads text with OCR
      Groups words into table cells
      Exports styled Excel file
    Tech stack
      Python
      EasyOCR
      OpenPyXL
    Use cases
      Digitize a scanned paper table
      Extract data from crooked PDFs
      Customize column boundaries
    Audience
      Developers
      Data entry automation

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Convert a scanned, tilted PDF table into a clean Excel spreadsheet automatically.

REASON 2

Define custom column boundaries and cleaning rules for a complex scanned table.

REASON 3

Use sheet-me's OCR and table parsing pieces directly inside a Python script.

REASON 4

Batch process printed lists or tables into formatted spreadsheets.

What's in the stack?

PythonEasyOCROpenPyXL

How it stacks up

deekshithvodela/sheet-me0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min
No license information is provided in the README.

Wtf does this do

sheet-me is a Python tool that takes scanned or crooked PDF documents, such as a photographed printed table or list, and turns them into clean, formatted Excel spreadsheets. It handles the fiddly parts of this process automatically, including straightening pages that were scanned at an angle and figuring out how scattered words on a page line up into rows and columns. The tool works in four steps. First it detects whether a page is tilted and rotates it straight. Then it uses optical character recognition, a technology that reads text out of images, through a library called EasyOCR, to pull out every word on the page along with its position. Next it groups words that sit on the same line into rows and sorts them into columns. Finally it builds a properly styled Excel file with sensible column widths, aligned text, and alternating row colors. You can run sheet-me straight from the command line on any PDF and it will guess a reasonable table layout automatically, producing a spreadsheet named after the original file. For trickier documents, you can write a JSON configuration file that defines exact column boundaries, a title, and cleaning rules for each column, such as fixing letters that OCR mistakes for numbers or standardizing how names are capitalized. The README also shows how to use sheet-me as a Python library directly, calling its OCR, deskewing, and table parsing pieces yourself for more control, and it documents the developer facing functions for anyone building on top of it. Installation is done through pip inside a Python virtual environment, and the README recommends this setup path explicitly for beginners. The project includes a test suite covering both the command-line interface and the table parsing logic. No license information is present in the README.

Yoink these prompts

Prompt 1
Help me install sheet-me in a Python virtual environment and run it on a PDF.
Prompt 2
Show me how to write a sample_config.json for sheet-me with custom column boundaries.
Prompt 3
Explain how to use sheet-me's OCREngine and TableParser classes directly in Python.
Prompt 4
Walk me through the column cleaner options sheet-me supports for fixing OCR mistakes.

Frequently asked questions

wtf is sheet-me?

A Python command line tool that turns scanned or tilted PDF tables into clean, styled Excel spreadsheets using OCR.

What language is sheet-me written in?

Mainly Python. The stack also includes Python, EasyOCR, OpenPyXL.

What license does sheet-me use?

No license information is provided in the README.

How hard is sheet-me to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is sheet-me for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.