O que CLI Epic Games (Legendary) faz?

Legendary é um substituto gratuito e de código aberto para o Launcher da Epic Games via linha de comando. Use esta skill quando o usuário quiser gerenciar sua biblioteca Epic pelo terminal — instalando jogos, lançando títulos, sincronizando saves na nuvem ou navegando pela coleção Epic.

Instalação

Pré-requisitos:

Python 3.9+ (64 bits)
Gerenciador de pacotes pip

Instale via PyPI (recomendado):

pip install legendary-gl

Para suporte a login via navegador web:

pip install legendary-gl[webview]

Alternativa: Instalar a partir do código-fonte

git clone https://github.com/derrod/legendary.git
cd legendary
pip install .

Configuração Inicial

Autenticação

Primeiro, autentique-se com sua conta Epic Games:

# Autenticação padrão (abre o navegador para login)
legendary auth

# Importar sessão existente do Launcher Epic Games (desloga você do EGL)
legendary auth --import

A autenticação via navegador irá:

Abrir seu navegador padrão para o login da Epic Games
Solicitar que você faça login com suas credenciais Epic
Exibir um código de autenticação
Salvar automaticamente sua sessão ao retornar ao terminal

Verificação

Verifique se está logado:

legendary whoami

A configuração é armazenada em ~/.config/legendary/config.ini (Linux/macOS) ou %APPDATA%\legendary\config.ini (Windows).

Visão Geral dos Comandos

Comando	Descrição
`legendary auth`	Autenticar com a Epic Games
`legendary list`	Listar todos os jogos na sua biblioteca
`legendary list-installed`	Listar jogos instalados e verificar atualizações
`legendary install <app>`	Instalar/baixar um jogo
`legendary launch <app>`	Iniciar/jogar um jogo
`legendary uninstall <app>`	Desinstalar um jogo
`legendary sync-saves`	Sincronizar saves na nuvem
`legendary egl-sync`	Sincronizar com o Launcher Epic Games

Casos de Uso Comuns

Navegar pela Sua Biblioteca de Jogos

# Listar todos os jogos na sua biblioteca Epic
legendary list

# Listar com informações detalhadas
legendary list --csv

# Forçar atualização dos metadados (útil se a lista parecer desatualizada)
legendary list --force-refresh

# Listar apenas conteúdo da Unreal Engine
legendary list --include-ue

Gerenciar Jogos Instalados

# Listar jogos instalados
legendary list-installed

# Verificar atualizações dos jogos instalados
legendary list-installed --check-updates

# Atualizar um jogo específico
legendary update <nome-do-app>

# Atualizar todos os jogos instalados
legendary update --skip-dlc

Instalar Jogos

# Instalar um jogo (use o nome do app do comando list)
legendary install Anemone

# Instalar em diretório personalizado
legendary install <nome-do-app> --base-path /caminho/para/jogos

# Instalar com plataforma específica
legendary install <nome-do-app> --platform Windows

# Instalar jogo com DLC
legendary install <nome-do-app> --include-dlc

# Instalar sem download seletivo (obtém todos os componentes)
legendary install <nome-do-app> --disable-sdl

# Instalação silenciosa (sem prompts)
legendary install <nome-do-app> -y

Iniciar Jogos

# Iniciar um jogo
legendary launch "world of goo"

# Iniciar em modo offline
legendary launch <nome-do-app> --offline

# Mostrar comando de inicialização sem executar
legendary launch <nome-do-app> --dry-run

# Iniciar com parâmetros personalizados
legendary launch <nome-do-app> --override-exe "caminho/para/exe" --working-dir "caminho/para/dir"

Gerenciamento de Saves na Nuvem

# Sincronizar todos os saves na nuvem (upload e download)
legendary sync-saves

# Apenas baixar saves (não enviar)
legendary sync-saves --skip-upload

# Forçar download mesmo se o local for mais recente
legendary sync-saves --force-download

# Limpar saves antigos na nuvem
legendary clean-saves

Informações do Jogo

# Obter informações detalhadas sobre um jogo
legendary info <nome-do-app>

# Listar arquivos no manifesto de um jogo
legendary list-files <nome-do-app>

# Listar saves na nuvem disponíveis para um jogo
legendary list-saves <nome-do-app>

Importar Jogos Existentes

Se você tiver jogos instalados via Launcher Epic Games:

# Importar um jogo do Launcher Epic Games
legendary import-game <nome-do-app> "/caminho/para/dir/instalacao/epic"

# Sincronização única com o Launcher Epic Games
legendary egl-sync --one-shot

# Sincronização contínua com o EGL (não disponível no macOS)
legendary egl-sync

Aliases para Conveniência

Crie aliases em ~/.config/legendary/config.ini:

[Legendary.aliases]
; Alias = Nome do App
HITMAN 3 = Eider
gtav = 9d2d0eb64d5c44529cece33fe2a46482

Em seguida, use os aliases nos comandos:

legendary launch HITMAN 3
legendary install gtav

Referência de Comandos

`legendary list [opções]`

Opção	Descrição
`--platform <p>`	Filtrar por plataforma (Windows/Mac)
`--include-ue`	Incluir conteúdo da Unreal Engine
`-T`	Desabilitar formatação do terminal
`--csv`	Saída no formato CSV
`--tsv`	Saída no formato TSV
`--json`	Saída no formato JSON
`--force-refresh`	Forçar atualização de todos os metadados

`legendary install <nome-do-app> [opções]`

Opção	Descrição
`--base-path <caminho>`	Diretório de instalação personalizado
`--platform <p>`	Plataforma específica
`--include-dlc`	Instalar DLC
`--disable-sdl`	Desabilitar download seletivo
`--reset-sdl`	Redefinir escolhas de download seletivo
`--skip-dl`	Pular download, apenas instalar
`-y`	Confirmar automaticamente todos os prompts
`--update`	Atualizar se já estiver instalado

`legendary launch <nome-do-app> [opções]`

Opção	Descrição
`--offline`	Iniciar em modo offline
`--dry-run`	Mostrar comando sem executar
`--json`	Saída das informações de inicialização como JSON
`--override-exe <caminho>`	Executável personalizado
`--working-dir <caminho>`	Diretório de trabalho personalizado

`legendary sync-saves [opções]`

Opção	Descrição
`--skip-upload`	Apenas baixar saves
`--force-download`	Forçar download sobrescrevendo o local
`--force-upload`	Forçar upload sobrescrevendo o remoto

Recursos Avançados

Jogos Multiplataforma

# Executar jogos Windows no Linux via Proton/WINE
legendary install <nome-do-app> --platform Windows
legendary launch <nome-do-app> --wine

# Executar via CrossOver (macOS)
legendary launch <nome-do-app> --crossover-bottle <nome-do-bottle>

Download Seletivo

O Legendary suporta download seletivo para economizar espaço em disco:

# Instalar com download seletivo habilitado
legendary install <nome-do-app>

# Redefinir seleção SDL
legendary install <nome-do-app> --reset-sdl

# Desabilitar SDL (obter todos os componentes)
legendary install <nome-do-app> --disable-sdl

Configuração

Edite ~/.config/legendary/config.ini:

[Legendary]
max_memory = 2048           ; Máx. memória compartilhada em MB
max_workers = 8             ; Máx. processos de trabalho
install_dir = ~/Games       ; Diretório de instalação padrão

Solução de Problemas

Problemas de Autenticação

Se a autenticação falhar:

# Limpar sessão existente
legendary auth --delete

# Reautenticar
legendary auth

Jogo Não Inicia

Verifique se o jogo precisa de autenticação online:
```
legendary launch <nome-do-app>
```

Tente o modo offline se o DRM permitir:

legendary launch <nome-do-app> --offline

Use --dry-run para ver o comando de inicialização:
```
legendary launch <nome-do-app> --dry-run
```

Downloads Lentos

Ajuste o número máximo de workers na configuração:

[Legendary]
max_workers = 16
max_memory = 4096

Importar do Launcher Epic Games

A versão macOS do EGL não suporta importação. Use:

# No Windows/Linux
legendary egl-sync

Recursos

GitHub Oficial: https://github.com/derrod/legendary
Documentação: https://github.com/derrod/legendary#readme
Pacote PyPI: https://pypi.org/project/legendary-gl/
Licença: GPL-3.0

Limitações

Sem compra de jogos (só pode baixar jogos já possuídos)
Não é possível reivindicar jogos gratuitos (deve usar a loja web ou o EGL)
Sincronização com EGL no macOS não suportada (limitação do EGL)
Requer uso do terminal (sem interface gráfica)

Ferramentas Alternativas

Para uma experiência com interface gráfica:

Heroic Games Launcher: https://heroicgameslauncher.com/ (Interface gráfica para o Legendary)
Lutris: https://lutris.net/ (Gerenciador de jogos Linux com integração ao Legendary)

Perguntar na sua IA favorita

Documentação