Configurar o gateway Index AMI pelo Linux: AppImage sem dependências

Quando usar a ferramenta de desktop?

O app Android cobre a configuração em campo: rápida, sem fios, ideal para técnicos de instalação. A ferramenta de desktop adiciona capacidades que o app não tem: preparar modelos de configuração para múltiplas unidades antes de ir a campo, recuperar e restaurar configurações a partir do arquivo conf.json, e acessar logs de sessão detalhados para diagnóstico avançado. Também é a única opção se o computador não tiver Bluetooth ou se o fluxo de trabalho requer automação.

Index AMI Configuration Tool é distribuído para Linux como um AppImage — um executável portátil que funciona em qualquer distribuição x86_64 sem instalação. Este guia cobre desde o download até o primeiro login.

Requisitos

• Linux x86_64 (Arch, Ubuntu, Debian, Fedora, openSUSE, etc.)
• ~100 MB de espaço livre em disco
• Para Bluetooth / BLE: serviço bluetoothd ativo + Python 3 + biblioteca bleak

Instalar bleak para Bluetooth (BLE)

Necessário apenas se você for usar a aba "Configurar dispositivo". O restante do aplicativo funciona sem Python.

# Verificar se o Python 3 está instalado
python3 --version

# Arch Linux
pip install bleak

# Ubuntu / Debian
pip3 install bleak
# Se falhar com erro PEP 668:
pipx install bleak

# Fedora
pip3 install bleak

# Verificar instalação
python3 -c "import bleak; print('bleak OK')"

Se o Bluetooth não aparecer ativo no aplicativo, verifique o serviço:

systemctl status bluetooth

Opção A — Portátil (recomendado)

A forma mais simples: baixe o AppImage, torne-o executável e execute-o de qualquer pasta.

chmod +x IndexAmiConfig-1.0.1-x86_64.AppImage
./IndexAmiConfig-1.0.1-x86_64.AppImage

O aplicativo abre imediatamente. Não modifica o sistema nem requer permissões de root.

Opção B — Instalação com atalho no menu

Se preferir que o aplicativo apareça no menu de pesquisa do sistema e na área de trabalho:

# 1. Tornar executável
chmod +x IndexAmiConfig-1.0.1-x86_64.AppImage

# 2. Criar diretórios
mkdir -p ~/.local/bin/ ~/.local/share/applications/ ~/Desktop/

# 3. Copiar aplicativo
cp IndexAmiConfig-1.0.1-x86_64.AppImage ~/.local/bin/IndexAmiConfig
chmod +x ~/.local/bin/IndexAmiConfig

# 4. Extrair ícone do AppImage
./IndexAmiConfig-1.0.1-x86_64.AppImage --appimage-extract
mkdir -p ~/.local/share/icons/hicolor/256x256/apps/
cp squashfs-root/index-ami-config.png ~/.local/share/icons/hicolor/256x256/apps/
rm -rf squashfs-root/

# 5. Criar entrada no menu
cat > ~/.local/share/applications/IndexAmiConfig.desktop << EOF
[Desktop Entry]
Version=1.0
Type=Application
Name=Index AMI Configuration Tool
Exec=/home/$(whoami)/.local/bin/IndexAmiConfig
Icon=index-ami-config
Categories=Utility;System;
Terminal=false
EOF

# 6. Atualizar cache
update-desktop-database ~/.local/share/applications/

Primeiro login

⚠ Altere a senha imediatamente após o primeiro login: Settings → Conta de usuário → Salvar credenciais.

Desinstalação

Seus dados são preservados por padrão. Se reinstalar o aplicativo, todos os seus modelos e configurações são restaurados automaticamente.

Se usou a Opção A (portátil):

rm IndexAmiConfig-1.0.1-x86_64.AppImage
# (Opcional) Excluir dados:
rm -rf ~/.config/IndexAmiConfig/

Se usou a Opção B (instalado no sistema):

killall IndexAmiConfig 2>/dev/null || true
rm ~/.local/bin/IndexAmiConfig
rm ~/.local/share/applications/IndexAmiConfig.desktop
rm ~/.local/share/icons/hicolor/256x256/apps/index-ami-config.png
update-desktop-database ~/.local/share/applications/
# (Opcional) Excluir dados:
rm -rf ~/.config/IndexAmiConfig/

Notas

• Offline: o aplicativo funciona sem conexão à internet.
• Dados: armazenados em ~/.config/IndexAmiConfig/ e preservados na desinstalação.
• Exportação: os arquivos conf.json são salvos em ~/Downloads/ por padrão.

Usando Windows? Consulte o guia de instalação para Windows.