Documentação

Guia completo para instalação, configuração e uso do StartWine-Launcher.

Primeiros passos

Bem-vindo ao StartWine-Launcher! Este guia irá ajudá-lo a começar rapidamente com o aplicativo.

O que é StartWine-Launcher?

StartWine-Launcher é um lançador gráfico para executar aplicativos e jogos Windows no Linux. Ele usa Wine, Proton-GE e Steam Proton para garantir máxima compatibilidade.

Interface gráfica amigável sem necessidade de usar o terminal
Suporte a múltiplas versões do Wine e Proton
Configuração automática de prefixes e dependências
Biblioteca de receitas prontas para aplicativos populares

Requisitos de sistema

SO: Qualquer distribuição Linux (Ubuntu, Fedora, Arch, etc.)
Processador: x86_64 (64-bit)
RAM: Mínimo 4 GB (recomendado 8 GB+)
Placa de vídeo: Suporte a Vulkan para melhor desempenho

Primeira execução

Após a instalação, o StartWine-Launcher criará automaticamente a estrutura de diretórios necessária e baixará os componentes básicos. Na primeira execução você verá:

Janela principal com a biblioteca de aplicativos
Barra lateral para navegação
Opção para adicionar um novo aplicativo ou jogo

Instalação

StartWine-Launcher é facilmente instalado com um único comando em qualquer distribuição Linux.

Instalação rápida

Execute um dos seguintes comandos no terminal:

Usando curl:

bash -c "$(curl -sL RusNor.github.io)"

Usando wget:

bash -c "$(wget -qO - RusNor.github.io)"

Para Ubuntu (se a instalação falhar)

Antes da instalação, execute:

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0 sudo tee -a /etc/sysctl.d/98-apparmor-unuserns.conf <<<kernel.apparmor_restrict_unprivileged_userns=0

Via AUR (Arch Linux)

Clone o repositório:

Usando AUR:

git clone https://aur.archlinux.org/startwine.git

Compile e instale o pacote.

Instalação manual

Baixe a versão mais recente do GitHub, HuggingFace ou Repo SW e extraia o arquivo.

Torne o arquivo executável:

chmod +x StartWine_v4XX

Execute com duplo clique ou com o comando:

./StartWine_v4XX

O que acontece durante a instalação?

1

Download do arquivo

A versão mais recente do StartWine-Launcher é baixada

2

Extração

O arquivo é extraído para ~/.local/share/StartWine/

3

Criação de atalho

Um atalho é adicionado à área de trabalho e ao menu de aplicativos

4

Configuração inicial

A estrutura básica de dados e configuração são criadas

Atualização

StartWine-Launcher verifica automaticamente atualizações na inicialização e oferece para instalar a nova versão.

Desinstalação

Para desinstalar o StartWine-Launcher, você pode usar um dos seguintes métodos:

Método 1: Através do menu de aplicativos

Encontre o atalho do StartWine no menu de aplicativos do seu sistema, clique com o botão direito e selecione "Desinstalar".

Método 2: Manualmente

Exclua a pasta ~/.local/share/StartWine/ e o atalho do aplicativo.

Estrutura de diretórios

Compreender a estrutura de arquivos e pastas do StartWine-Launcher ajudará você a gerenciar aplicativos e prefixes de forma eficiente.

Diretório principal

Todos os arquivos do StartWine-Launcher são armazenados no diretório pessoal do usuário:

~/.local/share/StartWine/

Esta pasta contém todos os componentes necessários, configurações e dados dos aplicativos.

Estrutura de diretórios


    ~/.local/
    ├── bin/
    └── sw // script de inicialização do StartWine-Launcher
    └── share/
        └── StartWine/
           ├── data/
           ├── Games/
           └── Shortcuts/

Descrição dos diretórios

data/

Contém todos os dados do aplicativo: prefixes Wine, versões Wine/Proton, arquivos de configuração, logs e cache. Este é o diretório de trabalho principal do StartWine-Launcher, onde todos os componentes e configurações são armazenados.

Games/

Diretório para instalação de jogos e aplicativos. Armazena arquivos de programas Windows instalados. Cada jogo ou aplicativo pode ter seu próprio subdiretório com arquivos executáveis e recursos.

Shortcuts/

Contém atalhos para execução rápida de aplicativos. StartWine-Launcher cria automaticamente atalhos para aplicativos adicionados que podem ser usados para iniciar a partir do menu do sistema ou área de trabalho.

Estrutura do data/

O diretório data/ contém todos os componentes técnicos e dados do aplicativo:


   ~/.startwine/data/
   ├── app_config/
   ├── app_patches/
   ├── app_saves/
   ├── img/
   ├── pfx/
   ├── pfx-backup/
   ├── runtime/
   ├── scripts/
   ├── tmp/
   ├── tools/
   └── wine/

Descrição dos subdiretórios do data/

app_config/

Arquivos de configuração dos aplicativos. Armazena configurações para cada aplicativo adicionado, incluindo parâmetros de inicialização, variáveis de ambiente e preferências do usuário.

app_patches/

Patches e modificações para aplicativos. Contém patches especiais e correções para melhorar a compatibilidade de aplicativos específicos.

app_saves/

Backups de saves de jogos e dados de aplicativos. Contém três elementos principais:

Public/ - arquivos e saves compartilhados
steamuser/ - saves para jogos Steam
user - link simbólico para o diretório pessoal do usuário

img/

Imagens, ícones e temas. Armazena todos os recursos gráficos para a interface:

app_icons/ - ícones de aplicativos (default, heroes, horizontal, vertical)
gui_icons/ - ícones da interface do sistema (controller, hicolor) nos formatos PNG e SVG
launcher_icons/ - ícones de lançadores (heroes, horizontal, install_launchers, vertical)
sw_themes/ - temas (background, css, sounds) com opções custom, dark, light

pfx/

Prefixos Wine (ambientes Windows virtuais). Cada prefixo contém um ambiente Windows isolado com suas próprias configurações, bibliotecas e aplicativos instalados.

pfx-backup/

Backups em formato de imagem ISO:

pfx_default.iso - imagem com bibliotecas e componentes básicos
saves_backup.iso - imagem com saves de jogos

runtime/

Ambiente de execução e componentes de inicialização:

afqls/ - bibliotecas adicionais
ssrv/ - componentes de servidor
sw - link simbólico para ~/.local/bin
sw_runtime/ - contêiner Void Linux de arquivo único para execução em ambiente isolado
version - arquivo com a versão do SW
nvidia/ - criado apenas para GPUs NVIDIA (ausente para Intel/AMD)

scripts/

Scripts de instalação e configuração. Contém scripts automatizados para instalar aplicativos, configurar prefixes e executar tarefas especiais.

tmp/

Arquivos temporários e caches. Contém dados temporários durante a instalação e operação:

cdrom/ - montagem de imagens ISO
icons/ - armazenamento temporário de ícones
logs/ - logs de instalação e operação
stats/ - estatísticas e métricas
vulkan_shader_cache/ - cache de shaders Vulkan

Pode ser limpo com segurança para liberar espaço em disco.

tools/

Ferramentas de compatibilidade e utilitários adicionais:

utils/ - utilitários auxiliares
config/ - configurações de camadas de compatibilidade
d3d_extras/ - bibliotecas Direct3D adicionais
dgvoodoo2/ - emulador Glide e DirectX
dlss_extras/ - componentes NVIDIA DLSS
lossless/ - lossless scaling
Proton BattlEye Runtime/ - anti-cheat BattlEye
Proton EasyAntiCheat Runtime/ - anti-cheat EasyAntiCheat
vulcan/ - versões DXVK e vkd3d-proton

wine/

Versões Wine e Proton. Armazena todas as versões baixadas de Wine-Staging, Wine-Staging-TKG, Proton-GE, Proton-EM e Steam Proton para uso com aplicativos.

Estrutura do prefixo

Cada prefixo em data/pfx/ imita a estrutura do Windows e contém:


    ~/.startwine/data/pfx/game1/
    ├── drive_c/
    │   ├── Program Files/
    │   ├── Program Files (x86)/
    │   ├── users/
    │   └── windows/
    ├── dosdevices/
    └── system.reg

Backup

Importante: Para fazer backup de todos os seus dados, aplicativos e saves, basta copiar a pasta ~/.startwine/ para um local seguro.

Para restaurar, copie a pasta de volta. Todos os aplicativos, configurações e saves serão restaurados.

Liberando espaço

Se você precisa liberar espaço em disco:

Exclua prefixes não utilizados da pasta data/pfx/
Exclua versões antigas do Wine/Proton da pasta data/wine/
Exclua jogos não utilizados da pasta Games/
Limpe arquivos temporários da pasta data/tmp/
Exclua backups antigos da pasta data/pfx-backup/

Ferramentas

Visão geral das principais seções e funções do StartWine-Launcher. Cada ferramenta está acessível através do menu lateral do aplicativo.

Jogos e aplicativos

A tela principal do StartWine-Launcher. Exibe sua biblioteca de todos os jogos e aplicativos Windows adicionados em uma grade conveniente com capas. Permite iniciar rapidamente qualquer aplicativo, visualizar suas configurações ou removê-lo da biblioteca.

Exibição de jogos e aplicativos instalados como blocos com capas
Início rápido clicando na capa
Menu de contexto com configurações para cada aplicativo
Pesquisa e filtragem da biblioteca

Arquivos

Gerenciador de arquivos integrado para navegar pelo sistema de arquivos e conteúdo dos prefixes Wine. Permite visualizar arquivos de aplicativos, gerenciar o conteúdo do disco virtual C:\ e encontrar os arquivos executáveis necessários.

Navegação pelo sistema de arquivos Linux e prefixes Wine
Visualização do conteúdo do disco virtual C:\
Execução de arquivos .exe diretamente do gerenciador de arquivos
Acesso rápido aos diretórios Games, Shortcuts, rootfs

Navegador Web

Navegador web integrado baseado em Chromium para visualizar páginas web dentro do StartWine-Launcher. Permite baixar instaladores de jogos e aplicativos diretamente do navegador, bem como usar versões web de serviços de jogos e lançadores.

Navegador integrado baseado em Chromium
Download de instaladores diretamente através da interface SW
Visualização de sites oficiais de jogos e lojas
Integração com o gerenciador de arquivos para executar arquivos .exe baixados
Suporte a favoritos e histórico de navegação

GOG Games

Integração com a plataforma GOG Galaxy. Permite importar jogos da sua biblioteca GOG, instalá-los e executá-los através do StartWine-Launcher com configuração automática de compatibilidade.

Importação de jogos da biblioteca GOG
Adição automática de jogos à biblioteca comum SW
Execução de jogos GOG com suporte a saves na nuvem
Configuração automática do prefixo Wine para cada jogo

Epic Games

Integração com a plataforma Epic Games Store. Permite importar seus jogos da Epic Games, instalá-los através do lançador oficial e executá-los através do StartWine-Launcher com configurações de compatibilidade ideais.

Importação de jogos da biblioteca Epic Games
Execução da Epic Games Store através do Wine com configurações predefinidas
Adição automática de jogos importados à biblioteca SW
Suporte a jogos gratuitos recebidos semanalmente
Otimização para Epic Games usando Proton-GE ou Wine-Staging-TKG

Aplicativos e lojas

Catálogo de receitas prontas para instalação automática de aplicativos Windows populares e lançadores de jogos. A instalação ocorre em um clique com configuração automática de todos os componentes e dependências necessários.

Receitas prontas para Epic Games, Battle.net, Rockstar Games, EA Play e outros
Configuração automática de prefixo e dependências
Instalação em um clique sem configuração manual
Atualizações regulares do banco de dados de receitas

Versões do Wine

Gerenciador de versões Wine e Proton. Permite baixar, instalar e gerenciar diferentes versões das camadas de compatibilidade. Você pode manter várias versões simultaneamente e atribuir diferentes versões para diferentes aplicativos.

Download e instalação de Wine-Staging, Wine-Staging-TKG, Proton-GE, Steam Proton
Gerenciamento de várias versões simultaneamente
Atualização automática para as versões mais recentes
Exclusão de versões não utilizadas para liberar espaço

Configurações da interface

Personalização da aparência e comportamento do StartWine-Launcher. Permite alterar o tema, esquema de cores, estilo dos botões de controle da janela, idioma da interface e outros parâmetros.

Inicialização automática do StartWine na bandeja ao iniciar o sistema
Restaurar menu após sair de um jogo ou aplicativo
Seleção de idioma da interface
Parada automática de processos Wine após sair do aplicativo
Ocultar automaticamente os painéis superior e inferior
Tema personalizado: cores de fundo, cor de destaque, estilo dos botões da janela
Tema de ícones integrado com seleção de paleta de cores

Desligar

O último item do menu lateral do StartWine-Launcher. Quando clicado, encerra todos os processos ativos do StartWine-Launcher, incluindo processos Wine/Proton em execução e serviços relacionados. Use para desligar completamente o aplicativo.

Encerra todos os processos Wine/Proton em execução
Para os serviços em segundo plano do StartWine-Launcher
Libera recursos do sistema ocupados
Garante o encerramento correto de todos os componentes

Dica: É recomendado usar o botão "Desligar" em vez de simplesmente fechar a janela para garantir o encerramento completo de todos os processos Wine e liberação de recursos.

Funcionalidades

Descrição detalhada das capacidades de configuração e gerenciamento do StartWine-Launcher. Descubra o que e onde configurar para um desempenho ideal dos aplicativos.

Menu de contexto do aplicativo

Clicar com o botão direito em qualquer jogo ou aplicativo na biblioteca abre um menu de contexto com opções avançadas de gerenciamento.

Executar — execução rápida do aplicativo
Abrir — abrir o diretório do jogo no gerenciador de arquivos
Configurações do aplicativo — alterar parâmetros de execução, prefixo Wine, variáveis de ambiente
Renomear — alterar o nome exibido do jogo
Especificar novo local — alterar o caminho para o arquivo executável
Excluir — remover o aplicativo da biblioteca (os arquivos não são excluídos)
WineHQ — abrir a página do aplicativo no banco de dados de compatibilidade WineHQ
ProtonDB — abrir a página do jogo no banco de dados ProtonDB para ver avaliações
Pesquisar imagem — encontrar e definir uma capa para o jogo
Atalho no menu — adicionar atalho ao menu de aplicativos do sistema
Atalho na área de trabalho — criar atalho na área de trabalho

Estatísticas e gerenciamento de dados do aplicativo

Para cada jogo ou aplicativo na biblioteca, informações detalhadas sobre tempo de uso, tamanho do diretório e FPS médio estão disponíveis. Abra o menu de contexto do aplicativo e selecione "Configurações do aplicativo", clique no ícone de informações ao lado do nome.

Tempo total de jogo — contagem do tempo gasto no aplicativo (exibido em dias, horas)
Número médio de quadros — FPS médio para avaliação de desempenho
Tamanho do diretório — espaço em disco ocupado pelo aplicativo e seus dados
Atalho na área de trabalho — alternância para criação/exclusão rápida de atalho
Atalho no menu — adição de atalho ao menu de aplicativos do sistema
Abrir local do arquivo — acesso rápido ao diretório do arquivo executável
Pesquisar imagem — pesquisa e instalação automática da capa do jogo a partir do banco de dados online
Galeria de ícones — seleção de ícone alternativo entre opções predefinidas

Painel de controle de execução

Na parte inferior da janela de configurações do aplicativo há um painel de controle com os principais elementos para executar e configurar jogos e programas.

Parar (quadrado) — parar o aplicativo em execução e todos os processos Wine associados
Iniciar (botão de execução) — executar o aplicativo com as configurações atuais
Seleção da versão Proton/Wine — lista suspensa para selecionar uma versão de compatibilidade específica (GE-Proton9-20, Wine-Staging, etc.)
Prefixo do aplicativo — selecionar ou criar um novo prefixo Wine isolado para o aplicativo
Configurações (engrenagem) — acesso a configurações avançadas de execução, parâmetros de linha de comando e variáveis de ambiente

Recomendação: Para a maioria dos jogos modernos, é recomendado usar GE-Proton, pois essas versões incluem patches adicionais para melhor compatibilidade. É recomendado usar um prefixo separado para cada jogo para evitar conflitos entre diferentes configurações e bibliotecas.

Menu de ferramentas de prefixo e Wine

O botão "Ferramentas" abre um menu com capacidades avançadas de gerenciamento do prefixo Wine e do aplicativo.

Ferramentas de prefixo:

Excluir prefixo atual — exclusão completa do prefixo e seus dados
Reinstalar prefixo — criar um novo prefixo limpo
Backup do prefixo — salvar o estado atual do prefixo
Restaurar prefixo — restaurar a partir de uma cópia criada anteriormente
Backup de saves — arquivar saves de jogos
Restaurar saves — restaurar saves de jogos

Ferramentas Wine:

Configurações Wine — configuração de bibliotecas, gráficos e som
Console Wine — linha de comando para depuração
Editor de registro — editar o registro do Windows no prefixo
Explorador de arquivos — gerenciador de arquivos Wine integrado
Desinstalador — remover programas instalados do prefixo
Winetricks — instalar bibliotecas, fontes e componentes DirectX
Limpar cache de shaders — liberar espaço excluindo o cache
Configurações do controlador (gamepad) — configurar suporte a gamepad, mapeamento de botões e vibração

Redefinição das configurações do aplicativo

Se um aplicativo não estiver funcionando corretamente ou se você quiser retornar às configurações padrão, o StartWine fornece um botão "Redefinir configurações do aplicativo" no menu de contexto (clique direito no bloco do aplicativo).

O que é redefinido:

Todos os parâmetros de execução voltam aos valores padrão
As variáveis de ambiente do Wine são redefinidas
As configurações de versão Wine/Proton voltam ao padrão do sistema
O prefixo do aplicativo é recriado com as bibliotecas básicas

O que é preservado:

Todos os saves de jogos permanecem em data/app_saves/
Mods instalados e conteúdo do usuário
Capturas de tela e gravações de jogo

Nota: Backups de prefixos são automaticamente salvos em data/pfx-backup/ como imagens ISO antes da redefinição. Você pode restaurar o estado anterior do prefixo a partir do backup, se necessário.

Configurações de execução de aplicativos

Para cada aplicativo ou jogo adicionado, configurações de execução individuais estão disponíveis. Abra o menu de contexto do aplicativo (clique direito no bloco) e selecione "Configurações do aplicativo". A seção fornece controle total sobre os parâmetros de execução do aplicativo, variáveis de ambiente Wine e tecnologias de otimização de desempenho.

Parâmetros básicos

LAUNCH_PARAMETERS — parâmetros de linha de comando (ex: -d3d9, -d3d11, -opengl)
WINEDLLOVERRIDES — substituição de bibliotecas DLL (ex: libglesv2=d)
WINDOWS_VER — versão do Windows para emulação (Windows 10, 8.1, 7, XP)
REGEDIT_PATCH — aplicar patches de registro na execução
DXVK_VER — versão DXVK para DirectX 9/10/11
VKD3D_VER — versão VKD3D para DirectX 12
FSR_MODE — modo AMD FidelityFX Super Resolution
LANG_MODE — idioma para o jogo ou aplicativo

Desempenho e monitoramento

FPS_LIMIT — limite de taxa de quadros (0 = sem limites)
WINE_CPU_TOPOLOGY — limitação de núcleos de CPU
WOW64 — modo de execução de aplicativos de 32 bits em prefixo de 64 bits sem usar bibliotecas de 32 bits (melhora a estabilidade e compatibilidade)
DXVK_GE — usar DXVK do wine-proton-ge
VKD3D_GE — usar VKD3D do wine-proton-ge
GALLIUM_HUD — monitoramento do sistema para OpenGL
MANGOHUD — monitoramento em modos OpenGL ou Vulkan
MESA_OVERLAY_HUD — monitoramento em modo Vulkan

Compatibilidade e gráficos

VIRTUAL_DESKTOP — emulação da área de trabalho do Windows
CONTROLLER — redirecionar controlador para outros dispositivos de entrada
NTSYNC — implementação alternativa de sincronização baseada em eventos NT (pode melhorar o desempenho em aplicações multithread em comparação com FSYNC/ESYNC)
FSYNC — melhoria da taxa de quadros através do agendamento de políticas
ESYNC — aumento de desempenho para jogos dependentes de CPU
OLD_GL_STRING — para jogos antigos com longas strings de extensão
NVAPI_DISABLE — desativar nvapi para aceleração CUDA
WAYLAND — usar o protocolo Wayland nativo em vez de X11 para Wine (melhora o desempenho e reduz a latência em ambientes Wayland)
WINEDBG_DISABLE — desativar modo de depuração do Wine
LARGE_ADDRESS_AWARE — alocar mais de 2 GB de memória para aplicações de 32 bits

Tecnologias de otimização

WINE_SIMULATE_WRITECOPY — simular cópia na escrita para DLLs
STAGING_SHARED_MEMORY — otimizar chamadas Wineserver
DXVK_HUD — monitoramento do sistema em DXVK
ENABLE_VKBASALT — camada de pós-processamento Vulkan para gráficos
FSR — AMD FidelityFX Super Resolution para aumentar FPS
DRI_PRIME — gerenciamento de gráficos híbridos em laptops
WINE_MONO — implementação multiplataforma do .NET Framework

Anti-cheats e opções adicionais

BATTLEYE — suporte anti-cheat BattlEye para jogos online
EASYANTICHEAT — suporte anti-cheat EasyAntiCheat
D3D_PLUGINS — pré-carregar bibliotecas D3D
VSYNC_DISABLE — desativar VSync à força
HIDE_NVIDIA_GPU — ocultar detecção de GPU NVIDIA
DGVOODOO2 — para jogos DirectX 8 e inferiores no modo DXVK
DLSS — Nvidia DLSS para escalonamento e altas taxas de quadros
DISABLE_UPDATE_PFX — desativar atualização do prefixo na execução
SHADER_CACHE — ativar/desativar cache de shaders

Elementos de controle da interface

Barra de navegação superior

Ir para o diretório pessoal — salto rápido para o diretório pessoal do usuário
Mostrar barra de pesquisa — abre uma barra de pesquisa para busca rápida de arquivos e diretórios
Barra de endereço — exibe o caminho atual e permite entrada manual de caminho para navegação rápida
Menu do diretório atual — ações adicionais com o diretório atual
Ir para o diretório pai — navegar para o diretório pai
Menu do botão de cabeçalho — configurações e opções adicionais do aplicativo

Barra de navegação inferior

Mostrar/ocultar painel de navegação — abre o menu lateral com as principais seções do SW
Mostrar/ocultar lista de volumes — exibe os drives conectados e seu uso
Mostrar/ocultar lista de favoritos — acesso rápido aos diretórios favoritos
Mostrar/ocultar lista de reprodução — player multimídia para arquivos de áudio
Painel de navegação — a área central mostra a seção atual e permite alternar entre seções adjacentes com setas

Configurações de exibição

Alterar tamanho dos ícones — ajuste o tamanho dos blocos de jogos e aplicativos (de pequenos a grandes)
Alterar esquema de cores — escolha entre tema escuro, claro ou personalizado
Ícones verticais ou horizontais — alternar entre visual compacto vertical e banners horizontais largos

Logs e depuração

Os logs de operação dos aplicativos são salvos para diagnóstico de problemas e depuração.

data/logs/ — logs principais do SW
data/tmp/logs/ — logs temporários de instalação

Nas configurações do aplicativo, você pode ativar a variável de ambiente WINEDEBUG=+all para obter informações detalhadas sobre a operação do Wine.

Teclas de atalho

O StartWine-Launcher suporta um extenso sistema de teclas de atalho para teclado e gamepad, permitindo controlar rapidamente o aplicativo sem usar o mouse. Você pode personalizar as atribuições de teclas de acordo com suas preferências através do menu "Teclas de atalho".

Sobre o aplicativo

A seção "Sobre" contém informações sobre a versão atual do StartWine-Launcher, novidades do projeto, autores e licença. Aqui você também pode verificar atualizações.

Novidades — lista de alterações e novos recursos na versão atual
Detalhes — descrição completa das capacidades do StartWine-Launcher
Autores — informações sobre os desenvolvedores e colaboradores
Licença — termos de uso e distribuição
Ajudar o projeto — maneiras de apoiar o desenvolvimento do StartWine
Verificar atualizações — verificação automática da disponibilidade de nova versão

Ajuda

A seção "Ajuda" abre o navegador web integrado com a documentação oficial do StartWine-Launcher.

Repositório oficial — https://github.com/RusNor/StartWine-Launcher
Repositório de dados (HuggingFace) — https://huggingface.co/RusNor/StartWine-data
Repositório de dados (espelho) — https://startwine-launcher.ru/StartWine-data/

Gerenciamento da janela

Minimizar — minimizar a janela para a bandeja do sistema ou barra de tarefas
Maximizar — expandir a janela para tela cheia ou retornar ao tamanho normal
Fechar — fechar a janela atual (use o botão "Desligar" na barra lateral para encerramento completo)

Configuração

Configure o StartWine-Launcher de acordo com suas necessidades para obter o máximo desempenho.

O que é um Prefixo?

Prefixo (Prefix) — um ambiente Windows virtual isolado que contém todos os arquivos, bibliotecas e configurações necessárias para executar aplicativos Windows. Cada prefixo imita a estrutura de pastas do Windows (C:\, Program Files, etc.).

Benefícios do uso de prefixes separados:

Isolamento dos aplicativos entre si — conflitos são eliminados
Diferentes versões Windows para diferentes aplicativos (XP, 7, 10, 11)
Configurações individuais e DLLs para cada aplicativo
Fácil remoção — basta excluir a pasta do prefixo

Escolha da versão Wine/Proton

StartWine-Launcher suporta várias versões de camadas de compatibilidade:

Wine-Staging — camada de compatibilidade clássica. Adequado para a maioria dos aplicativos e jogos antigos.
Wine-Staging-TKG — versão experimental do Wine com patches adicionais e melhorias de desempenho. Recomendado para usuários avançados.
Proton-GE — versão otimizada do Proton com patches adicionais. Recomendado para jogos modernos.
Steam Proton — versão oficial do Proton da Valve. Melhor compatibilidade com jogos Steam.

Configuração gráfica

Para melhorar o desempenho nos jogos, configure os seguintes parâmetros:

DXVK — ative para jogos DirectX 9/10/11
VKD3D — ative para jogos DirectX 12
Esync/Fsync/NTsync — melhora o desempenho de aplicações multithread

Ferramentas adicionais

StartWine-Launcher suporta integração com ferramentas úteis para melhorar sua experiência de jogo:

MangoHud

Sobreposição de monitoramento de desempenho em jogos. Mostra FPS, temperatura da CPU/GPU, carga do processador, uso de memória e outras métricas em tempo real. Ative a chave nas configurações do aplicativo para exibir a sobreposição.

vkBasalt

Pós-processamento de imagem para jogos Vulkan. Permite aplicar efeitos de melhoria de imagem: nitidez (CAS), melhoria de cores, oclusão de ambiente (SMAA) e outros filtros. Especialmente útil para melhorar o visual em jogos antigos ou em baixa resolução.

Dica: Você pode combinar MangoHud e vkBasalt simultaneamente para monitoramento de desempenho e melhoria de imagem. Basta ativar ambas as chaves nas configurações do aplicativo.

Variáveis de ambiente

Você pode definir variáveis de ambiente adicionais para cada aplicativo através da interface de configurações. Variáveis populares:

DXVK_HUD=fps — mostrar FPS
WINE_FULLSCREEN_FSR=1 — ativar FSR
PROTON_USE_WINED3D=1 — usar WineD3D

Executando aplicativos

Saiba como adicionar e executar aplicativos e jogos Windows no StartWine-Launcher.

Adicionando um novo aplicativo

1

Clique no botão "+" ou "Adicionar aplicativo"

O botão está localizado na janela principal ou no menu lateral

2

Selecione o arquivo executável (.exe)

Especifique o caminho para o arquivo .exe do seu aplicativo

3

Selecione a versão Wine/Proton

Escolha uma versão adequada para execução

4

Configure parâmetros adicionais

Se necessário, configure variáveis de ambiente e parâmetros de compatibilidade

5

Clique em "Salvar"

O aplicativo será adicionado à sua biblioteca

Usando receitas prontas

Para aplicativos populares, receitas de instalação prontas estão disponíveis:

Abra a seção "Aplicativos e lojas"
Selecione o aplicativo desejado na lista
Clique em "Instalar" — tudo será configurado automaticamente

Gerenciamento de prefixes

Cada aplicativo pode ter seu próprio prefixo isolado (ambiente Windows virtual). Isso evita conflitos entre aplicativos.

Crie prefixes separados para diferentes aplicativos
Configure a versão do Windows para cada prefixo
Instale as DLLs e componentes necessários

Executando jogos

Dica: Para jogos, é recomendado usar Proton-GE ou Steam Proton com DXVK e VKD3D ativados para melhor desempenho.

A maioria dos jogos modernos funciona muito bem com essas configurações sem configuração adicional.

Solução de problemas

Soluções para problemas comuns ao trabalhar com o StartWine-Launcher.

O aplicativo não inicia

Tente as seguintes soluções:

Verifique os logs de execução em "Arquivos" → "Logs"
Experimente uma versão diferente do Wine/Proton
Certifique-se de que os componentes DLL necessários estão instalados
Verifique se há espaço em disco suficiente

Problemas gráficos

Tela preta ou artefatos:

Tente desativar DXVK e usar WineD3D
Atualize os drivers da placa de vídeo
Verifique o suporte Vulkan no seu sistema

Baixo desempenho:

Ative Esync/Fsync/NTsync nas configurações
Use Proton-GE em vez do Wine comum
Feche aplicativos em segundo plano desnecessários

Problemas de som

Se o som não funcionar ou estiver falhando:

Verifique as configurações de som do seu sistema
Certifique-se de que o PulseAudio ou PipeWire esteja funcionando corretamente
Tente alterar o driver de áudio nas configurações do Wine

Obtendo ajuda

Se o problema não for resolvido, entre em contato com a comunidade:

Canal Telegram Max mensageiro GitHub Issues

FAQ

Respostas para perguntas frequentes sobre o StartWine-Launcher.

Quais jogos e aplicativos são suportados?

StartWine-Launcher pode executar a maioria dos aplicativos e jogos Windows. A compatibilidade depende do aplicativo específico e da versão Wine/Proton selecionada. Verifique o banco de dados de compatibilidade em ProtonDB para jogos.

É necessário instalar o Wine separadamente?

Não, o StartWine-Launcher inclui todos os componentes necessários e não requer a instalação do Wine no sistema. Tudo funciona de forma isolada.

Posso usar com jogos do Steam?

Sim, você pode adicionar jogos do Steam ao StartWine-Launcher. No entanto, para jogos Steam, é recomendado usar o Proton integrado no próprio cliente Steam para melhor integração.

Como atualizar as versões Wine/Proton?

Vá para a seção "Versões do Wine" no menu lateral. Lá você pode baixar e instalar novas versões do Wine, Proton-GE e Steam Proton. O StartWine-Launcher gerencia automaticamente todas as versões.

É seguro usar o StartWine-Launcher?

Sim, o StartWine-Launcher é um projeto de código aberto. Todos os componentes são baixados de fontes oficiais. Os aplicativos são executados em prefixes isolados e não têm acesso direto ao seu sistema.

Qual é o desempenho em comparação com o Windows?

O desempenho depende do aplicativo específico. Muitos jogos rodam com 90-100% do desempenho nativo do Windows. Alguns jogos podem rodar ainda mais rápido graças às otimizações do Proton. Use Proton-GE e ative DXVK para melhores resultados.

Onde meus dados e saves são armazenados?

Todos os dados são armazenados no diretório ~/.local/share/StartWine/. Cada aplicativo tem seu próprio prefixo com saves e configurações. Você pode criar um backup desta pasta para salvar todos os dados.