copydetect
github.com
- Free plan
- Windows
- macOS
- Linux
- API
- Self-hosted
What copydetect is
copydetect is a free tool that compares code directories and creates HTML reports highlighting matching code slices. It uses Winnowing document fingerprinting and Pygments tokenization, covering the 500-plus languages Pygments can detect and tokenize. Users can compare test directories with reference code, such as previous submissions, and exclude boilerplate directories from matches. Noise, guarantee, and display thresholds adjust what is detected and shown. Install it with pip; it requires Python 3.7 or later. The command-line tool recursively searches supplied directories, while its Python API supports comparisons and HTML report generation. Reports can be saved to a chosen path, highlighted code can be truncated, and custom CSS can be linked. Settings can be supplied through command-line arguments or a JSON configuration file. The package is MIT-licensed, classified for Education, and listed with Beta development status. Its documentation cautions that it may not catch deliberate evasion and that a match does not establish plagiarism. It is available for self-hosted use and is classified as operating-system independent and Python 3 only.
Who it suits
copydetect may suit educators or other users who need to compare code submissions against reference directories. It is intended for Python 3 users comfortable with command-line or Python API workflows.
Good to know, and what to watch
- Compares test code with reference directories.
- Can exclude boilerplate from matches.
- Supports 500+ languages through Pygments.
- Offers command-line and Python API use.
- MIT-licensed and free.
- May miss plagiarism designed to evade detection.
- A detected match does not prove plagiarism.
- Requires Python 3.7 or later.
The verdict
copydetect offers configurable code comparison and report generation for directory-based checks. Treat its results as indicators rather than proof: the project warns that deliberate evasion may go undetected and matches do not establish plagiarism.
What the maker publishes
- Audience
- PyPI classifies copydetect as intended for Education and as a Beta development-status project. source
- Audience
- The package lists Education as its intended audience. source
- Command line
- The simplest command-line usage is copydetect -t DIRS, which recursively searches supplied directories and compares files. source
- Comparison options
- Users can compare test directories with reference directories and exclude matches found in boilerplate directories. source
- Configuration
- Settings can be supplied through command-line arguments or a JSON configuration file. source
- Detection limitation
- The documentation says copydetect identifies likely plagiarism, is not guaranteed to catch dedicated evasion, and does not prove plagiarism occurred. source
- Detection method
- It uses the Winnowing document-fingerprinting approach used by the MOSS platform. source
- Filtering
- Tokenization and filtering replace variable names with V, function names with F, object names with O, and strings with S. source
- Installation
- The package is installed with pip and requires Python 3.7 or greater. source
- Installation
- The project documents installation with pip and requires Python 3.7 or later. source
- Language coverage
- Pygments tokenization gives copydetect support for all 500+ languages that Pygments can detect and tokenize. source
- Language support
- It uses Pygments for tokenization and supports the 500+ languages Pygments can detect and tokenize. source
- License
- The package is released under the MIT License. source
- License
- Copydetect is released under the MIT License. source
- Limitations
- The project says it is not guaranteed to catch plagiarism designed to evade detection and cannot guarantee that plagiarism occurred. source
- Method
- It is based on the Winnowing document fingerprinting approach, also used by MOSS. source
- Output customization
- Reports can be saved to a specified output path, highlighted code can be truncated, and custom CSS files can be linked. source
- Platforms
- The package is classified as operating-system independent and provides a Windows command entry point. source
- Platform support
- PyPI classifies the package as operating-system independent and Python 3 only. source
- Purpose
- Copydetect is a code plagiarism detection tool that compares code directories and generates an HTML report showing copied slices. source
- Purpose
- Copydetect detects likely code plagiarism by comparing code directories and generating an HTML report that displays copied slices. source
- Python API
- Copydetect provides a Python API with CopyDetector, CodeFingerprint, compare_files, and HTML report generation. source
- Python API
- Copydetect can also be run through a Python API that generates an HTML report. source
- Reference code
- Separate reference directories can be supplied, including previous submissions, and boilerplate directories can exclude provided code from plagiarism matches. source
Checked against the maker's pages on 2 Oct 2026.