whatisgithub

What is ecofont-script?

leegisker/ecofont-script — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5Setup · easy

In one sentence

A Python script that redraws PDF, Word, and Markdown text as outline-only strokes to cut printer ink use by up to 33 percent.

Mindmap

mindmap
  root((repo))
    What it does
      Outline-only text rendering
      Saves printer ink
      Batch converts files
    Tech stack
      Python
      pypdf
      ReportLab
    Use cases
      Cut ink for printed reports
      Batch convert PDFs Word Markdown
      Preview with dry run
    Audience
      General users
      Office workers
    Formats
      PDF
      docx
      Markdown

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

What do people build with it?

USE CASE 1

Convert a folder of PDFs, Word documents, or Markdown files into ink-saving stroke-only versions before printing.

USE CASE 2

Preview which files would be converted and where output would land using dry-run mode.

USE CASE 3

Adjust stroke width to balance readability against ink savings for a specific document.

USE CASE 4

Automate ink-saving conversion for reports before sending them to a shared printer.

What is it built with?

PythonpypdfReportLab

How does it compare?

leegisker/ecofont-script0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity2/54/51/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Just pip install pypdf and reportlab, or use the -y flag to auto-install missing packages.

No license information is provided in the README.

So what is it?

This is a Python command-line script that converts documents into an ink-saving format for printing. The idea is simple: instead of filling each letter solid with ink, the script redraws the text as outlines only, just the strokes of each character, not the filled interior. This technique, the same approach used by the Ryman Eco font, can save up to 33% of printer ink while the text still looks normal on screen. You drop your files into a folder called Conversion Folder, run the script, and the converted files appear in a Converted folder automatically. The script supports PDF files, Word documents (.docx), and Markdown files (.md). For PDF files it works by decompressing each page's content stream, stripping any existing text rendering settings, and inserting a stroke-only rendering command around each block of text, then recompressing the result. For Word and Markdown documents, the script first renders the content to a temporary PDF using ReportLab, then applies the same eco transformation. You can also run it directly on specific files, point it at a custom folder, or use a dry-run mode to preview what would happen without actually changing anything. The stroke width, meaning how thick the character outlines are, is adjustable with a command-line flag, letting you balance ink savings against readability. Dependencies are pypdf, reportlab, and optionally python-docx for Word support, and a flag lets the script install any missing packages automatically. The tool requires Python 3.10 or newer.

Copy-paste prompts

Prompt 1
Help me install and run EcoFONT-Script to convert a folder of PDFs to ink-saving mode.
Prompt 2
Explain how EcoFONT-Script's stroke-width option affects readability and ink savings.
Prompt 3
Walk me through converting a single .docx file with EcoFONT-Script and customizing the output folder.
Prompt 4
Show me how EcoFONT-Script modifies a PDF's content stream to draw outline-only text.

Frequently asked questions

What is ecofont-script?

A Python script that redraws PDF, Word, and Markdown text as outline-only strokes to cut printer ink use by up to 33 percent.

What language is ecofont-script written in?

Mainly Python. The stack also includes Python, pypdf, ReportLab.

What license does ecofont-script use?

No license information is provided in the README.

How hard is ecofont-script to set up?

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

Who is ecofont-script for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.