QzonePhoto

Project Overview

QzonePhoto is a desktop client for people who want to pull their QQ Zone content back to local disk, built around the problem of bulk-saving albums, videos, and feed media. It is an Electron 43.7 and Vue 3 app that reuses the official QQ Zone web endpoints for sign-in and data access, keeping cookies and p_skey on the local machine. It also uploads local photos and videos into chosen albums and exports friend groups, group members, and closeness lists.

Item	Value
Platform	Windows, macOS, Linux
Stack	Electron 43.7 + Vue 3.5
Current version	2.9.0
Sign-in	QR code or local QQ account
License	GPL-3.0-only

Downloads land under a two-level QQ number / album name tree, with originals and videos side by side.

Key Features

• Album batch download: select albums individually or tick all, with tasks queued in the bottom Download Manager
• Original resolution first: photos are fetched at native size, videos are saved as the MP4 the service transcodes to
• Feed aggregation: downloading one post pulls every original image and video inside that post
• Resume support: restarting a job skips files that already exist under the same name
• Upload with quota: drag or multi-select local files into an album and watch disk and daily upload quotas
• Contact backups: exports an HTML overview, a JSON dataset, a CSV summary, and a TXT readme
• Friend space switching: opening a friend from the bottom drawer keeps the current tab and reloads their data
• Privacy mode: one toggle masks media, avatars, nicknames, post text, and comments
• Festival themes: National Day, New Year, and Spring Festival schemes switch on a time window
• In-app updates: checks for a new build, shows download progress, and installs it directly

Interface and Usage

• Album view: permission state and visitor stats on top, album groups and original previews below
• Three content tabs: Photos, Videos, and Feeds filter independently, and photos can be filtered by year and source
• Download Manager: a persistent bottom entry with task filters, batch pause or resume, save location, and concurrency
• Friend drawer: group, "who I care about", and "who cares about me" views plus group member lists
• Title bar: a Feedback button submits short reports in-app and falls back to the GitHub issue page

Target Audience

• Users archiving albums accumulated over many years
• People uploading local photos and videos back to their space in bulk
• Users who want a copy of friend groups and group member lists
• Desktop users who prefer large-screen batch selection and file sorting

Quick Start

1. Open Releases and pick the package for your system: *-win-x64-setup.exe or *-win-ia32-setup.exe on Windows
2. On first launch, scan the QR code, or use one-click local sign-in when QQ Desktop is already running
3. Tick the albums you want and start the download, or switch to Photos, Videos, or Feeds to grab the whole current list
4. Open the Download Manager, set a folder in Change location, and drop concurrency to 1 or 2 if transfers are slow
5. To upload, open an album, click Upload photos, and drag files in while watching the quota bar
6. For a backup, open the friend drawer, choose Backup list, and pick the current list or all contacts; the job appears in the Download Manager

System Requirements

Item	Requirement
OS	Windows, macOS, Linux
Packages	Windows x64 and ia32, macOS arm64 and x64 DMG, Linux AppImage and deb
Source builds	Node.js ≥ 20.19, pnpm 10.33.2
Default output	C:/Users/<user>/Pictures/QzonePhoto/ on Windows, ~/Pictures/QzonePhoto/ on macOS and Linux

Notes

• Unsigned macOS build: the DMG is not signed or notarized by Apple, and macOS 15 and later ignores right-click workarounds, so allow it from System Settings → Privacy & Security → Open Anyway
• Visibility limits: private albums, password-protected albums, and albums whose question was not answered are skipped; friend content is limited to what the account may view
• Media formats: photos are JPG, PNG, GIF, BMP, WEBP; videos are MP4, MOV, AVI, usually arriving as MP4 after server transcoding
• Log file: diagnostics always use qzone-helper-dev.log, stored under ~/Library/Application Support/qzone-photo/ on macOS
• Sign-in state: local sign-in needs QQ Desktop logged in; if avatars are missing, sign out and back in or press Ctrl/Cmd + R