📦 Tachibk Converter

A Termux-friendly tool to convert .tachibk, .proto, and .proto.gz backup files (from Tachiyomi, Mihon, and forks) into readable .json and .txt formats — and restore them back to valid .tachibk format.

---

⚙️ Features

• ✅ Convert .tachibk, .proto, or .proto.gz → output/output.json
• ✅ Interactive file selector based on saved backup time
• ✅ Export categorized manga to .txt in manga/sub/
• ✅ Export source-wise manga lists in manga/extension/
• ✅ Filter categories from JSON using CLI interface
• ✅ Convert filtered or custom JSON back into .tachibk
• ✅ Re-encode output/output.json → .tachibk safely
• ✅ Supports Mihon, TachiyomiSY, J2K, Komikku, and others
• ✅ Works entirely offline after setup

---

🧠 Setup

1. Place your backup files in:

~/tachibk-converter/backup/

Supported formats:

• .tachibk
• .proto
• .proto.gz

Example:

backup/xyz.jmir.tachiyomi.mi_2025-06-06_11-09.tachibk
backup/tachiyomi_2023-10-02_00-51.proto.gz

---

2. Add this function to your ~/.bashrc

tachibk() {
    cd ~/tachibk-converter/

    mkdir -p backup output

    echo "🔍 Scanning backup/ for backup files..."
    local files=($(ls -t backup/*.tachibk backup/*.proto backup/*.proto.gz 2>/dev/null))

    if [ ${#files[@]} -eq 0 ]; then
        echo "❌ No backup files found in backup/"
        cd ~
        return 1
    fi

    echo "📦 Found backup files:"
    local i=1
    for f in "${files[@]}"; do
        echo "  $i) $(basename "$f")"
        ((i++))
    done

    echo -n "➡️  Enter the number of the file to convert: "
    read -r selection

    if ! [[ "$selection" =~ ^[0-9]+$ ]] || [ "$selection" -lt 1 ] || [ "$selection" -gt ${#files[@]} ]; then
        echo "❌ Invalid selection."
        cd ~
        return 1
    fi

    local file="${files[$((selection-1))]}"
    local filename=$(basename "$file")

    echo "📦 Selected: $filename"
    python3 tachibk-converter.py --input "$file" --output output/output.json --fork mihon

    if [ -f output/output.json ]; then
        echo "📂 Processing output/output.json..."
        python3 extract_titles_and_folders.py
        python3 count_cleaned_output.json_.py
        python3 category_filter.py
        echo "🔁 You can now convert it back using:"
        echo "    python3 json_to_tachibk.py --input output/output.json --output restored.tachibk"
    else
        echo "❌ Failed to create output/output.json"
    fi

    cd ~
}

Then reload your shell:

source ~/.bashrc

---

🚀 One-Command Usage

tachibk

This will:

• Let you pick a .tachibk, .proto, or .proto.gz file from backup/
• Convert it to output/output.json
• Extract and group manga into manga/sub/ and manga/extension/
• Filter categories from JSON (optional)
• Show read stats
• Let you restore to .tachibk using the filtered JSON

---

🥪 Manual Usage

python3 tachibk-converter.py --input backup/your_file.tachibk --output output/output.json --fork mihon
python3 extract_titles_and_folders.py
python3 count_cleaned_output.json_.py
python3 category_filter.py
python3 json_to_tachibk.py --input output/output.json --output restored.tachibk

---

🔁 Restore JSON → .tachibk

python3 json_to_tachibk.py --input output/output.json --output restored.tachibk
cp restored.tachibk /sdcard/Download/

You can also use your own or a filtered .json file (from category_filter.py).

Then restore it in Tachiyomi or Mihon:

Settings → Backup & Restore → Restore

---

📁 Folder Structure

tachibk-converter/
├── backup/
│   └── *.tachibk / *.proto / *.proto.gz
├── output/
│   └── output.json
├── restored.tachibk
├── tachibk-converter.py
├── json_to_tachibk.py
├── extract_titles_and_folders.py
├── count_cleaned_output.json_.py
├── category_filter.py
├── manga/
│   ├── all.json
│   ├── sub/
│   │   └── [category].txt
│   └── extension/
│       └── [source].txt

---

✅ Requirements

• Python 3
• Termux or any Linux shell
• Protobuf compiler (protoc) if generating schema
• Python packages:

pip install protobuf requests varint

---

📚 Notes

• Works with Mihon, SY, J2K, Komikku, etc.
• Only .tachibk, .proto, .proto.gz are supported
• Preferences decoding is experimental
• Safe: does not modify original backups

---

🙏 Credits

• Based on BrutuZ/tachibk-converter
• Extended and maintained by @Mohin2295747 for Termux + Mihon support