douban-backup
Command-line backup of Douban marks for books, films, music, games and dramas (want to see / watching / watched), exported to Excel in a structure consistent with Douban Buddy.
Translated from Chinese · show originalhide original
命令行备份豆瓣账号的书影音游剧标记（想看/在看/看过），导出为与「豆伴」结构一致的 Excel。
- backup
- cli
- douban
- douban-backup
- excel
- python
- Stars
- 749
- Forks
- 299
- + today
- +7
- Created
- 3mo
Ranking data as of October 21, 2026 (UTC).
Star History
Today, hour by hour
Overview
Command-line backup of Douban marks for books, films, music, games and dramas (want to see / watching / watched), exported to Excel in a structure consistent with Douban Buddy. It ranks #29 on GitTiger, gaining +7 stars on October 21, 2026 (UTC).
The project is written in Python and has 299 forks. It was created 3mo ago.
What it is
douban-backup is a Python command-line tool, MIT-licensed, that backs up a Douban account's media marks (wishlist, in progress, completed) across movies, music, books, games and TV series. Per the description, it exports to an Excel file whose structure matches that of the "豆伴" (Douban companion) tool.
Described capabilities
- Five categories covered: movies, music, books, games and series, each with want/doing/done states. - Cookie handling: the README preview says it reads cookies automatically from Chrome, Edge, Brave, Firefox or Safari, or you can supply them manually. - Excel output said to match the original plugin exactly: 14 sheets, a fixed 9-column header, sorted by id descending. - Incremental backup: entries update only when status, short review, rating or tags change, with older versions archived as history. - Built-in rate limiting and fault tolerance for HTTP 500 errors, falling back to item-by-item fetching when a page fails.
Getting started
No install or run commands were supplied in the data. Follow the README at https://github.com/zcyoung2000/douban-backup.
git clone https://github.com/zcyoung2000/douban-backup.git
cd douban-backup
# see README for setupFrequently Asked Questions
What does it back up?
Douban marks for movies, music, books, games and series, in want, doing and done states.
What format is the export?
An Excel file; the README preview says it has 14 sheets and a fixed 9-column header, matching 豆伴's structure.
Do I need to provide my login cookies?
Not necessarily: it reads them from supported browsers (Chrome, Edge, Brave, Firefox, Safari), or you can provide them manually.
Does it re-download everything each run?
The README preview describes incremental backups that update only when status, review, rating or tags change.