Home - JohanDevl/Export_Trakt_4_Letterboxd GitHub Wiki

Export Trakt 4 Letterboxd Wiki

Welcome to the official wiki of the Export Trakt 4 Letterboxd project. This wiki contains all the necessary documentation to install, configure, and use the export tool.

What is Export Trakt 4 Letterboxd?

Export Trakt 4 Letterboxd is a tool that allows you to export your Trakt.tv data (watched movies, ratings, watchlist, collections, TV shows) to a format compatible with Letterboxd for easy import.

Current Version (1.x): Built with Bash scripting for reliability and cross-platform compatibility.

Upcoming Version 2.0: Complete rewrite in Go for enhanced performance, maintainability, and advanced features.

The project allows you to:

Export watched movies from Trakt.tv
Export ratings with customizable rating scale conversion
Export your watchlist
Export your movie collections
Export TV shows (for reference)
Generate Letterboxd-compatible CSV files
Configure detailed export options
Automate exports with Docker

Version 2.0 - Go Implementation (Coming Soon)

The next major version will bring significant improvements:

Modern Go architecture with enhanced performance
Internationalization support (English and French)
Advanced error handling and logging
Comprehensive test coverage
Enhanced API client with retry mechanisms
Improved configuration management

Main Sections

Installation - How to install the tool
Configuration - How to configure the tool
Usage - How to use the tool
CLI Reference - Command-line interface reference
Export Features - Detailed export functionality
Trakt API Guide - Working with the Trakt API
Docker - Docker usage guide
Cron Jobs - Scheduling and automation
Internationalization - Language support (v2.0+)
Testing - Testing framework and benchmarks (v2.0+)
CI/CD - Continuous integration and deployment
Migration Guide - Migration from Bash to Go (v2.0)
Release Plan - Future development roadmap
Troubleshooting - Solutions to common problems
Contributing - How to contribute to the project

Quick Links

Acknowledgements

This project was originally based on the work by u2pitchjami and is being continuously improved with enhanced features and a planned complete rewrite in Go.