Skip to content
100% local

Soroban abacus converter

Convert numbers to Japanese soroban abacus notation and back.

Input
Output

Soroban abacus converter

A soroban is the Japanese abacus: one column of beads per decimal digit, with a single "heaven" bead worth five above the bar and four "earth" beads worth one each below it. This tool converts a plain number into that bead pattern, and reads a bead pattern back into the number it represents — useful for soroban lessons, teaching material, or checking a value worked out by hand.

Direction controls which way the conversion runs; Auto-detect decides per value — a string of digits becomes soroban notation, and a valid bead pattern becomes a number. Notation format picks how a column is written: Beads draws every bead as a filled or empty dot (●○○○○ for one, ●●●●● for nine), while Compact writes a caret for an active heaven bead plus the earth-bead count (^4 for nine), quicker to type by hand. Column separator sets what goes between one digit's column and the next — space, middle dot, or pipe — and reading uses that same character to split the columns apart. Maximum digits caps the valid range, from 1 up to 21 decimal digits; anything longer is rejected rather than silently truncated.

Turn on batch mode to convert a whole list at once, one value per line, keeping a column of numbers and a column of soroban notation lined up. With batch mode off, the whole input is read as a single value, handy when a bead pattern itself contains spaces. Leading zeros are stripped before conversion, and CRLF and LF line endings work the same.

Everything runs locally in your browser — no number you type or paste is ever uploaded anywhere. Copy the result, download it as a .txt file, or send the output back into the input to convert it the other way.

FAQ

What do the two beads in each soroban column mean?
The bead above the bar ("heaven") is worth 5 when pushed toward the bar; the four beads below it ("earth") are worth 1 each when pushed up. A column's value is the sum of its active beads, from 0 to 9.
How is a value greater than 9 represented?
Each decimal digit gets its own column, read left to right just like a written number — the tens column, the units column, and so on — separated by the column separator you choose.
What is the difference between the Beads and Compact formats?
Beads draws every bead as ● (active) or ○ (inactive), which mirrors a real abacus. Compact writes a caret for an active heaven bead plus the earth-bead count, which is shorter to type and read when you already know the notation.
Why does the tool reject some soroban notation?
A column must be in its canonical resting position — beads move toward the bar with no gaps — so a pattern like a lone raised bead in the middle of the earth beads is not a valid column and is reported as an error.
Is my input uploaded anywhere?
No. The conversion runs entirely in your browser, using ordinary JavaScript — nothing you type or paste ever leaves your device.