submitter

Tool to submit solutions to online judges directly from the command line.

Installation

Pre-built binaries

Download the latest binary for your platform from the releases page:

• Linux (Debian/Ubuntu): submitter_<version>_amd64.deb — install with sudo dpkg -i submitter_*.deb
• macOS (Apple Silicon): submitter-<version>-aarch64-macos.dmg — open the disk image and copy submitter to a directory on your PATH (e.g. /usr/local/bin). The binary is unsigned; on first launch, right-click → Open to bypass Gatekeeper.
• Windows: submitter-<version>-x86_64-windows.exe — place anywhere on your PATH.

From source

You need Rust.

cargo install --git https://github.com/EgorKulikov/submitter

Usage

submitter <task url> <language> <path to solution>
submitter login <site>

Credentials are prompted on first use and saved for subsequent runs in .submitter_cookies.json.

Pre-contest login

Use submitter login <site> to authenticate before a contest starts, so you don't waste time during the contest:

submitter login ucup
submitter login atcoder
submitter login codeforces
submitter login eolymp
submitter login yandex

Accepted short names: ac, atcoder, cf, codeforces, cc, codechef, ucup, uoj, yandex, ya, toph, kattis, eolymp, eol, luogu, lg, coderun, cr, kep, kepuz, repovive, rv. Full URLs also work.

Supported sites

Site	Submit	Verdict	Auth
AtCoder	via browser (opens page, copies to clipboard)	HTTP polling	browser cookie (EditThisCookie)
Codeforces	via browser (opens page, copies to clipboard)	API polling	API key + secret
CodeChef	API	API	username + password
Yandex Contest	API	API	OAuth (device code flow)
UOJ / UCup	HTTP	HTTP	username + password
Toph	API	API	username + password
Kattis	API	API	username + token (.kattisrc)
Eolymp	API	API	API key
Luogu	via browser (opens page, copies to clipboard)	HTTP polling	browser cookie (EditThisCookie)
CodeRun	API	API	browser cookie (EditThisCookie)
KEP.uz	API	API	browser cookie (EditThisCookie)
Repovive	API	API	browser cookie (EditThisCookie)

Notes

• AtCoder: on first use, export cookies from browser using EditThisCookie extension and paste the JSON when prompted
• Codeforces: requires API key and secret from https://codeforces.com/settings/api
• Yandex Contest: on first use, opens browser to authorize via Yandex account
• Kattis: download your .kattisrc from https://open.kattis.com/download/kattisrc and place it in your project or home directory
• Eolymp: requires API key from https://eolymp.com/developer with scopes: atlas:problem:read, atlas:submission:read, atlas:submission:write, judge:contest:read, judge:contest:participate
• Luogu: on first use, export cookies from browser using EditThisCookie extension and paste the JSON when prompted
• CodeRun: on first use, export cookies from any logged-in yandex.ru tab using EditThisCookie extension and paste the JSON when prompted
• KEP.uz: on first use, export cookies from a logged-in kep.uz tab using EditThisCookie extension and paste the JSON when prompted
• Repovive: on first use, export cookies from a logged-in repovive.com tab using EditThisCookie extension and paste the JSON when prompted

Examples

# AtCoder
submitter "https://atcoder.jp/contests/abc388/tasks/abc388_a" "Rust" solution.rs

# Codeforces
submitter "https://codeforces.com/contest/1/problem/A" "C++" solution.cpp

# CodeChef
submitter "https://www.codechef.com/problems/TEST" "C++" solution.cpp

# Yandex Contest
submitter "https://contest.yandex.com/contest/3/problems/B/" "C++" solution.cpp

# UOJ
submitter "https://uoj.ac/problem/1" "C++14" solution.cpp

# UCup
submitter "https://contest.ucup.ac/contest/1106/problem/A" "C++17" solution.cpp

# Toph
submitter "https://toph.co/p/add-them-up" "C++" solution.cpp

# Kattis
submitter "https://open.kattis.com/problems/hello" "C++" solution.cpp

# Eolymp (archive)
submitter "https://eolymp.com/en/problems/1" "C++" solution.cpp

# Eolymp (contest)
submitter "https://eolymp.com/en/contests/CONTEST_ID/problems/A" "C++" solution.cpp

# Luogu
submitter "https://www.luogu.com.cn/problem/P1001" "C++" solution.cpp

# CodeRun
submitter "https://coderun.yandex.ru/problem/thermal-panels" "Rust" solution.rs

# KEP.uz (archive problem)
submitter "https://kep.uz/problems/1" "Rust" solution.rs

# KEP.uz (contest problem)
submitter "https://kep.uz/contests/487/problem/A" "Rust" solution.rs

# Repovive
submitter "https://repovive.com/contests/10/problems/A" "Rust" solution.rs