Repository navigation
Import Export RU
Tonkatsu Box использует файлы .xcollx для обмена коллекциями. Один файл содержит все элементы, метаданные, обложки, раскладку Canvas и настройки.
- Откройте коллекцию
- Нажмите меню (⋮) → Экспорт
- Выберите куда сохранить файл
.xcollx - Готово - файл включает всё: элементы, обложки, оценки, статусы, Canvas
- Все элементы коллекции с метаданными
- Обложки (встроены в файл)
- Ваши оценки и статусы
- Комментарии автора
- Раскладка Canvas - элементы, заметки, связи, позиции
- Изображения Canvas
- Ваши теги и то, у каких элементов они стоят
При экспорте доступен опциональный чекбокс «Включить персональные данные». При включении экспорт также содержит:
- Статус пользователя и даты (начало, завершение, последняя активность)
- Личные заметки (комментарии пользователя)
- Прогресс серий (текущий сезон, текущий эпизод)
- Отметки просмотренных серий - какие именно серии отмечены; при импорте они проставляются в целевой коллекции
- Лайки и заметки на сериях, сезонах, главах и других единицах
- Порядок сортировки и дату добавления
Файлы с персональными данными имеют флаг user_data: true в заголовке. При импорте персональные данные восстанавливаются автоматически, если присутствуют. Файлы без флага импортируются как раньше (обратная совместимость).
- Элементы Wishlist
- API ключи и настройки приложения
- Перейдите на вкладку Коллекции
- Нажмите Импорт (или меню → Импорт)
- Выберите файл
.xcollx - Выберите: создать новую коллекцию или добавить в существующую
- Импорт запускается - элементы сопоставляются с базой данных и добавляются
Полный экспорт (.xcollx): Все элементы, обложки, метаданные, раскладка Canvas и тир-листы. Импорт работает оффлайн.
Лёгкий экспорт (.xcoll): Только элементы и метаданные, файл меньше. При импорте требуются API ключи для загрузки обложек и данных. Каждый элемент дозагружается из того источника, откуда он пришёл, поэтому сериалы TVmaze, тайтлы Kitsu и MangaDex и книги возвращаются со своим источником, а не только элементы TMDB и AniList.
В лёгких файлах, выгруженных версиями до 0.40, нет идентификатора провайдера для книг и манги MangaDex: они приезжают нераспознанными, и это лечится Обновлением из источника на элементе.
При импорте в существующую коллекцию дубликаты обновляются (комментарий автора, оценка). Тир-листы и теги из файла импортируются. Раскладка Canvas пропускается во избежание дублирования (canvas-элементы не имеют unique constraint).
- Создаётся коллекция (или выбирается существующая)
- Элементы добавляются со статусами и оценками
- Обложки извлекаются и сохраняются локально
- Раскладка Canvas восстанавливается (если есть)
- Если медиа-данные не встроены - загружаются из API
Если импорт не удался, приложение теперь показывает полный текст ошибки с кнопкой копирования, а не обрезанное сообщение. Вы видите, что именно пошло не так, и можете скопировать текст, чтобы приложить его к обращению за помощью.
Скачивайте готовые коллекции прямо из приложения: Настройки > Импорт > Каталог коллекций. В каталоге 45+ коллекций для 32 платформ, а также фильмы и аниме.
Если вы ведёте список где-то ещё или генерируете его скриптом, карточки можно загрузить прямо из файла JSON или CSV: Настройки → Импорт → Свои карточки. Обязательны только название и тип, всё остальное - год, жанры, обложка, платформа, ваш статус, оценка, заметки, даты и теги - по желанию.
Помимо экспорта в файл, можно скопировать коллекцию как форматированный текст в буфер обмена:
-
Копировать списком: Быстрое копирование по шаблону
{name} ({year})- один клик, без диалога - Копировать как текст…: Диалог с настраиваемым шаблоном, чипами-токенами, сортировкой и предпросмотром
Доступные токены: {name}, {year}, {rating}, {myRating}, {platform}, {status}, {genres}, {notes}, {type}, {link}, {#}
{link} выводит страницу элемента в его источнике - IGDB для игр, TMDB для фильмов и сериалов, AniList для аниме и манги, вашу собственную ссылку для кастомных элементов. {type} печатает тип, под которым показан кастомный элемент (Игра, Аниме, ...), а не общее «Custom». Пустой токен удаляется вместе со своим разделителем.
Пользовательский шаблон сохраняется между сессиями.
.xcollx - ZIP-архив с JSON-данными и встроенными изображениями. Это открытый формат - можно распаковать и изучить содержимое. Полная спецификация: RCOLL_FORMAT.md.
Резервное копирование всего в один клик: Настройки → Бэкап → Бэкап всех данных. ZIP-архив включает:
- Все коллекции - с оценками, статусами, заметками, досками Canvas и сохранёнными обложками
- Ваши теги
- Тир-листы и mood-сетки
- Элементы Wishlist
- Прогресс по просмотренным сериям сериалов и аниме
- Список отслеживаемых релизов и записи календаря
- Прогресс трекеров RetroAchievements и Steam
- Настройки приложения
Старые бэкапы, сделанные до появления части этих данных, всё равно восстанавливаются - просто в них не будет того, чего тогда ещё не было.
Восстановление сохраняет исходные даты: когда была создана коллекция и когда был добавлен каждый элемент, поэтому история «добавлено по месяцам» в Статистике переживает круг. Шаблоны подписей и подписей ячеек mood-сеток тоже возвращаются.
Для восстановления: Настройки → Бэкап → Восстановить из бэкапа → выберите ZIP-файл. Диалог подтверждения показывает превью манифеста (количество коллекций, элементов, wishlist-записей) с чекбоксами для восстановления wishlist и настроек. Коллекции всегда создаются как новые (без слияния). Wishlist-записи дедуплицируются по тексту.
Когда вы запускаете восстановление, приложение открывает поверх остального интерфейса окно «Восстановление из резервной копии, не закрывайте приложение. На больших копиях операция может занять несколько минут». На нём показан счётчик восстановленных коллекций.
Пока идёт восстановление:
- Кнопка «назад» не работает.
- На компьютере закрытие окна через панель задач или Alt+F4 отменяется.
- Счётчик увеличивается только после того как очередная коллекция полностью сохранена.
В самом конце показывается стадия «Завершаем…». Окно закрывается только после того как данные действительно записались. «Готово» вы не увидите пока приложение ещё пишет.
- Используйте Полный бэкап для полного снимка - это быстрее, чем экспортировать коллекции по отдельности
- Делитесь файлами
.xcollxс друзьями - они могут импортировать напрямую - Готовые коллекции работают без API ключей
- Каталог онлайн-коллекций - скачивание готовых коллекций из каталога
- Импорт из Trakt - импорт фильмов и сериалов из Trakt.tv
- Импорт из Steam - импорт библиотеки игр Steam
- Импорт из RetroAchievements - импорт ретро-игр с прогрессом ачивок
- Импорт из MyAnimeList - импорт списков аниме и манги с MAL
- Импорт из AniList - импорт списков аниме и манги с AniList
- Импорт списка IGDB - импорт списка игр, выгруженного с IGDB.com
- Импорт из Kinorium - импорт списков фильмов и сериалов с Кинориума
- Импорт своих карточек - загрузка своих карточек из файла JSON или CSV