EmuGUI

EmuGUI

O que devo dizer? Não gostei das interfaces QEMU existentes para Windows, então criei a minha própria.

Espelhos

Liberar	Link
Estável	Link
Pré-lançamentos	Link

Versionamento

Última atualização: 28 de janeiro de 2023 com 1.0.0.5307_b1

Número da versão

Começando com 0.7, o esquema de versionamento fica assim:

Recurso	Contente
Principal	incrementos a cada primeira atualização de recurso em um ano
Menor	torna-se 0 quando há grandes incrementos, caso contrário, aumenta a cada atualização de recurso dentro de um ano
Micro	torna-se 0 a cada atualização de recurso, caso contrário aumenta em 1 a cada atualização de correção de bug
Nano	é o número da compilação

Se _dev for adicionado, será um pré-lançamento não destinado à produção.

Se _b1 e um número forem adicionados, a versão EmuGUI estará em um estado onde recursos menores ainda podem ser adicionados, mas começará a se concentrar na estabilidade. Geralmente, você não deve usá-lo para produção, pois ainda é um pré-lançamento.

Se _rc e um número forem adicionados, o lançamento deverá ser focado apenas na estabilidade e integridade, mas ainda não para uso produtivo.

Código da versão

Para o verificador de atualização, um código de versão está sendo usado em vez do número. Veja como ele aumenta:

Tipo de atualização	Código da próxima versão
Atualização de visualização	código da versão atual + 1
Correção de bug/pequena atualização	código da versão atual + 1
Atualização de recursos	código da versão atual arredondado para a próxima centena (por exemplo, 4237 torna-se 4300)

Requisitos do sistema

Componente	Exigência
SO	Windows 10, Windows Server 2016 ou posterior (x64); A versão mais recente (LTS) da sua distribuição Linux (x64)
Pitão	3.6 ou mais recente
Processador	Processador x64 Dual Core com @2,6 GHz¹
BATER	6GB¹
Disco rígido	2 GB¹

¹ Este é o mínimo absoluto, o desempenho necessário depende do sistema operacional que você deseja executar.

Dependências

• Pitão 3
• PyQt6
• PySide 6
• QEMU
• Magia Python
• solicitações

Instalação (Windows)

1. Obtenha o QEMU e instale-o
2. Obtenha o EmuGUI e extraia-o
3. Execute emugui.exe no diretório EmuGUI.
4. Defina os caminhos do QEMU na guia Configurações/QEMU.
5. Crie uma nova máquina virtual e inicie-a.

Instalação (Linux)

1. Abra seu terminal e digite um dos comandos para atualizar seu sistema, dependendo da sua distro:

   • Arco: sudo pacman -Syu
   • Debian/Ubuntu: sudo apt-get update && sudo apt-get upgrade
   • Fedora/RHEL 8: sudo dnf upgrade --refresh ou sudo dnf update
   • Gentoo: sudo emaint -a sync && sudo emerge --ask --verbose --update --deep --newuse @world
   • RHEL 7: sudo yum update
   • SUSE e openSUSE Leap: sudo zypper patch && sudo zypper up
   • openSUSE Tumbleweed: sudo zypper patch && sudo zypper dup

2. Abra seu terminal e digite um dos comandos para instalar o QEMU, dependendo da sua distribuição:

   • Arco: sudo pacman -S qemu
   • Debian/Ubuntu: sudo apt-get install qemu
   • Fedora: sudo dnf install @virtualization
   • Gentoo: sudo emerge --ask app-emulation/qemu
   • RHEL: sudo yum install qemu-kvm
   • (aberto-)SUSE: sudo zypper install qemu

3. A partir do EmuGUI 2.0, você também precisa instalar (lib)xcb-cursor0 para que isso funcione.

   • Arco: sudo pacman -S libxcb-cursor
   • Debian/Ubuntu: sudo apt install libxcb-cursor-dev
   • Fedora: sudo dnf install libxcb-cursor
   • Gentoo: sudo emerge -av x11-libs/libxcb-cursor
   • RHEL: sudo yum install libxcb-cursor
   • (aberto-)SUSE: sudo zypper in libxcb-cursor

4. Obtenha o EmuGUI deste site e extraia-o.

5. Execute emugui no diretório EmuGUI (se falhar no gerenciador de arquivos, abra um terminal dentro do diretório e digite ./emugui ).

6. Defina os caminhos do QEMU na guia Configurações/QEMU ( /usr/bin/qemu-system-* ou apenas qemu-system-* ).

7. Crie uma nova máquina virtual e inicie-a.

Outra dica: Se quiser que uma máquina rode com KVM, você deve abrir um terminal dentro do diretório e digitar: sudo ./emugui .

Atualizando EmuGUI

1. Feche o EmuGUI antes de atualizar.
2. Abra o navegador de sua preferência e vá para o repositório EmuGUI.
3. Se a versão mais recente do EmuGUI for mais recente que a que você está executando atualmente, baixe e extraia o arquivo zip do EmuGUI.
4. Se você tiver arquivos BIOS externos no diretório raiz da instalação antiga do EmuGUI, copie-os para o diretório raiz da nova.
5. Inicie a nova instalação do EmuGUI. Talvez seja necessário reinstalar algumas máquinas virtuais.

Construir conteúdo

• Compilando no Windows (Python Venv, Qt instalado via Python, com PyInstaller)
• Compilando no Windows (Python Venv, Qt instalado via Python, com cx_Freeze)
• Compilando no Windows (Python Venv, Qt instalado via instalador oficial, com PyInstaller)
• Compilando no Windows (Python Venv, Qt instalado via instalador oficial, com cx_Freeze)
• Compilando no Windows (Anaconda, com PyInstaller)
• Compilando no Windows (Anaconda, com cx_Freeze)
• Compilando em Linux (Python Venv, Qt instalado via Python)
• Compilando em Linux (Python Venv, Qt instalado via instalador oficial)
• Construindo em Linux (Anaconda)

Compilando no Windows (Python Venv, Qt instalado via Python, com PyInstaller)

1. Instale o Python. Você pode obtê-lo aqui
2. Obtenha o QEMU e instale-o
3. Instale o Git. Você pode obtê-lo aqui
4. Instale o código do Visual Studio. Você pode obtê-lo aqui
5. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git
6. Abra o Visual Studio Code nessa pasta.
7. Abra um terminal DENTRO do código VS e digite: python -m pip install --upgrade pip venv
8. Depois de fazer isso, digite: python -m venv your-venv-name FORA da pasta de código. Você pode chamá-lo como quiser, mas não se esqueça que NÃO é permitido entrar no repositório EmuGUI em nenhuma circunstância.
9. Espere até que o VS Code perceba seu local e selecione-o. Talvez seja necessário reiniciar o editor para que ele reconheça seu ambiente virtual após ele ter sido criado.
10. Com seu ambiente virtual selecionado, tente executar um script Python. Se gerar um erro, tudo bem. Só precisamos ativar o venv de qualquer maneira.
11. No terminal VS Code que acabamos de abrir, digite: pip install --upgrade pip PyInstaller PyQt6 PyQt6-tools PySide6 python-magic-bin requests python-dateutil psutil
12. Depois de fazer isso, execute o script main.py.
13. Para compilar o programa para usuários que não possuem Python instalado, digite: PyInstaller --icon .EmuGUI.ico .emugui.py
14. Depois de terminar, copie o código para a pasta dist criada pelo PyInstaller.
15. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.
16. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Compilando no Windows (Python Venv, Qt instalado via Python, com cx_Freeze)

1. Instale o Python. Você pode obtê-lo aqui
2. Obtenha o QEMU e instale-o
3. Instale o Git. Você pode obtê-lo aqui
4. Instale o código do Visual Studio. Você pode obtê-lo aqui
5. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git
6. Abra o Visual Studio Code nessa pasta.
7. Abra um terminal DENTRO do código VS e digite: python -m pip install --upgrade pip venv
8. Depois de fazer isso, digite: python -m venv your-venv-name FORA da pasta de código. Você pode chamá-lo como quiser, mas não se esqueça que NÃO é permitido entrar no repositório EmuGUI em nenhuma circunstância.
9. Espere até que o VS Code perceba seu local e selecione-o. Talvez seja necessário reiniciar o editor para que ele reconheça seu ambiente virtual após ele ter sido criado.
10. Com seu ambiente virtual selecionado, tente executar um script Python. Se gerar um erro, tudo bem. Só precisamos ativar o venv de qualquer maneira.
11. No terminal VS Code que acabamos de abrir, digite: pip install --upgrade pip cx_Freeze PyQt6 PyQt6-tools PySide6 python-magic-bin requests python-dateutil psutil
12. Depois de fazer isso, execute o script main.py.
13. Para compilar o programa para usuários que não possuem Python instalado, digite: cxfreeze -c emugui.py --target-dir dist --icon EmuGUI.ico
14. Depois de terminar, copie o código para a pasta dist cx_Freeze criada.
15. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.
16. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Compilando no Windows (Python Venv, Qt instalado via instalador oficial, com PyInstaller)

1. Instale o Python. Você pode obtê-lo aqui
2. Obtenha o QEMU e instale-o
3. Instale o Git. Você pode obtê-lo aqui
4. Instale o código do Visual Studio. Você pode obtê-lo aqui
5. Instale o Qt do seguinte site (você precisa de uma conta Qt para isso)
6. Você só precisa do Qt Creator.
7. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git
8. Abra o Visual Studio Code nessa pasta.
9. Abra um terminal DENTRO do código VS e digite: python -m pip install --upgrade pip venv
10. Depois de fazer isso, digite: python -m venv your-venv-name . FORA da pasta de código. Você pode chamá-lo como quiser, mas não se esqueça que NÃO é permitido entrar no repositório EmuGUI em nenhuma circunstância.
11. Espere até que o VS Code perceba seu local e selecione-o. Talvez seja necessário reiniciar o editor para que ele reconheça seu ambiente virtual após ele ter sido criado.
12. Com seu ambiente virtual selecionado, tente executar um script Python. Se gerar um erro, tudo bem. Só precisamos ativar o venv de qualquer maneira.
13. No terminal VS Code recém-aberto, digite: pip install --upgrade pip PyInstaller PySide6 python-magic-bin requests python-dateutil psutil
14. Depois de fazer isso, execute o script main.py.
15. Para compilar o programa para usuários que não possuem Python instalado, digite: PyInstaller --icon .EmuGUI.ico .emugui.py
16. Depois de terminar, copie o código para a pasta dist criada pelo PyInstaller.
17. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.
18. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Compilando no Windows (Python Venv, Qt instalado via instalador oficial, com cx_Freeze)

1. Instale o Python. Você pode obtê-lo aqui
2. Obtenha o QEMU e instale-o
3. Instale o Git. Você pode obtê-lo aqui
4. Instale o código do Visual Studio. Você pode obtê-lo aqui
5. Instale o Qt do seguinte site (você precisa de uma conta Qt para isso)
6. Você só precisa do Qt Creator.
7. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git
8. Abra o Visual Studio Code nessa pasta.
9. Abra um terminal DENTRO do código VS e digite: python -m pip install --upgrade pip venv
10. Depois de fazer isso, digite: python -m venv your-venv-name . FORA da pasta de código. Você pode chamá-lo como quiser, mas não se esqueça que NÃO é permitido entrar no repositório EmuGUI em nenhuma circunstância.
11. Espere até que o VS Code perceba seu local e selecione-o. Talvez seja necessário reiniciar o editor para que ele reconheça seu ambiente virtual após ele ter sido criado.
12. Com seu ambiente virtual selecionado, tente executar um script Python. Se gerar um erro, tudo bem. Só precisamos ativar o venv de qualquer maneira.
13. No terminal VS Code que acabamos de abrir, digite: pip install --upgrade pip cx_Freeze PySide6 python-magic-bin requests python-dateutil psutil
14. Depois de fazer isso, execute o script main.py.
15. Para compilar o programa para usuários que não possuem Python instalado, digite: cxfreeze -c emugui.py --target-dir dist --icon EmuGUI.ico
16. Depois de terminar, copie o código para a pasta dist cx_Freeze criada.
17. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.
18. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Compilando no Windows (Anaconda, com PyInstaller)

1. Instale o Anaconda. Você pode obtê-lo daqui
2. Obtenha o QEMU e instale-o
3. Instale o Git. Você pode obtê-lo daqui
4. Instale o código do Visual Studio. Você pode obtê-lo daqui
5. Instale o Qt. Você pode obtê-lo daqui
6. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git
7. Abra o Visual Studio Code nessa pasta.
8. Abra o Anaconda Navigator e crie um novo ambiente virtual.
9. Abra o venv no VS Code e tente executar um script Python com ele.
10. No terminal do VS Code, digite: & pip install --upgrade pip PyInstaller PySide6 python-magic-bin PyQt6 requests python-dateutil psutil
11. Depois de fazer isso, execute o script main.py.
12. Para compilar o programa para usuários que não possuem Python instalado, digite: & PyInstaller --icon .EmuGUI.ico .emugui.py
13. Depois de terminar, copie o código para a pasta dist criada pelo PyInstaller.
14. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.
15. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Compilando no Windows (Anaconda, com cx_Freeze)

1. Instale o Anaconda. Você pode obtê-lo daqui
2. Obtenha o QEMU e instale-o
3. Instale o Git. Você pode obtê-lo daqui
4. Instale o código do Visual Studio. Você pode obtê-lo daqui
5. Instale o Qt. Você pode obtê-lo daqui
6. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git
7. Abra o Visual Studio Code nessa pasta.
8. Abra o Anaconda Navigator e crie um novo ambiente virtual.
9. Abra o venv no VS Code e tente executar um script Python com ele.
10. No terminal do VS Code, digite: & pip install --upgrade pip cx_Freeze PySide6 python-magic-bin PyQt6 requests python-dateutil psutil
11. Depois de fazer isso, execute o script main.py.
12. Para compilar o programa para usuários que não possuem o Python instalado, digite: & cxfreeze -c emugui.py --target-dir dist --icon EmuGUI.ico
13. Depois de terminar, copie o código para a pasta dist cx_Freeze criada.
14. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.
15. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Compilando em Linux (Python Venv, Qt instalado via Python)

1. Instale o Python 3. Você pode compilar o código-fonte ou obtê-lo nos repositórios da sua distribuição.

2. Instale o QEMU usando um dos comandos listados em Instalação (Linux).

3. Instale o Git e o binutils usando o comando install da sua distribuição.

   • Arco: sudo pacman -S git binutils
   • Debian/Ubuntu: sudo apt install git binutils
   • Fedora: sudo dnf install git binutils
   • Gentoo: sudo emerge -ask dev-vcs/git para Git, sudo emerge --ask --oneshot sys-devel/binutils para binutils
   • RHEL: sudo yum install git binutils
   • (aberto-)SUSE: sudo zypper in git binutils

4. Instale o código do Visual Studio. Você pode obtê-lo aqui

5. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git

6. Como você já está com o terminal aberto, instale (lib)xcb-cursor0. Comandos para isso podem ser encontrados em Instalação (Linux).

7. Abra o Visual Studio Code nessa pasta.

8. Abra um terminal DENTRO do código VS e digite: python3 -m pip install --upgrade pip venv

9. Depois de fazer isso, digite: python3 -m venv your-venv-name . FORA da pasta de código. É por isso que o Git só será usado para clonar o código, mas não para confirmar - isso deve ser feito manualmente.

10. Espere até que o VS Code perceba seu local e selecione-o. Talvez seja necessário reiniciar o editor para que ele reconheça seu ambiente virtual após ele ter sido criado.

11. Com seu ambiente virtual selecionado, tente executar um script Python. Se gerar um erro, tudo bem. Só precisamos ativar o venv de qualquer maneira.

12. No terminal VS Code recém-aberto, digite: pip install --upgrade pip PyInstaller PySide6 python-magic requests python-dateutil psutil pyqtdarktheme

13. Depois de fazer isso, execute o script main.py.

14. Para compilar o programa para usuários que não possuem Python instalado, digite: PyInstaller --onefile emugui.py (para aqueles que conseguem fazer um VENV funcionar) ou python3 -m PyInstaller --onefile emugui.py

15. Depois de terminar, copie o código para a pasta dist criada pelo PyInstaller.

16. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.

17. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 7.

Compilando em Linux (Python Venv, Qt instalado via instalador oficial)

1. Instale o Python 3. Você pode compilar o código-fonte ou obtê-lo nos repositórios da sua distribuição.

2. Instale o QEMU usando um dos comandos listados em Instalação (Linux).

3. Instale o Git e o binutils usando o comando install da sua distribuição.

   • Arco: sudo pacman -S git binutils
   • Debian/Ubuntu: sudo apt install git binutils
   • Fedora: sudo dnf install git binutils
   • Gentoo: sudo emerge -ask dev-vcs/git para Git, sudo emerge --ask --oneshot sys-devel/binutils para binutils
   • RHEL: sudo yum install git binutils
   • (aberto-)SUSE: sudo zypper in git binutils

4. Instale o código do Visual Studio. Você pode obtê-lo aqui

5. Instale o Qt do seguinte site (você precisa de uma conta Qt para isso)

6. Você só precisa do Qt Creator.

7. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git

8. Como você já está com o terminal aberto, instale (lib)xcb-cursor0. Comandos para isso podem ser encontrados em Instalação (Linux).

9. Abra o Visual Studio Code nessa pasta.

10. Abra um terminal DENTRO do código VS e digite: python3 -m pip install --upgrade pip venv

11. Depois de fazer isso, digite: python3 -m venv your-venv-name . FORA da pasta de código. É por isso que o Git só será usado para clonar o código, mas não para confirmar - isso deve ser feito manualmente.

12. Espere até que o VS Code perceba seu local e selecione-o. Talvez seja necessário reiniciar o editor para que ele reconheça seu ambiente virtual após ele ter sido criado.

13. Com seu ambiente virtual selecionado, tente executar um script Python. Se gerar um erro, tudo bem. Só precisamos ativar o venv de qualquer maneira.

14. No terminal VS Code recém-aberto, digite: pip install --upgrade pip PyInstaller PySide6 python-magic requests python-dateutil psutil pyqtdarktheme

15. Depois de fazer isso, execute o script main.py.

16. Para compilar o programa para usuários que não possuem Python instalado, digite: PyInstaller --onefile emugui.py

17. Depois de terminar, copie o código para a pasta dist criada pelo PyInstaller.

18. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.

19. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Construindo em Linux (Anaconda)

1. Instale o Anaconda. Você pode obtê-lo daqui

2. Instale o QEMU usando um dos comandos listados em Instalação (Linux).

3. Instale o Git e o binutils usando o comando install da sua distribuição.

   • Arco: sudo pacman -S git binutils
   • Debian/Ubuntu: sudo apt install git binutils
   • Fedora: sudo dnf install git binutils
   • Gentoo: sudo emerge -ask dev-vcs/git para Git, sudo emerge --ask --oneshot sys-devel/binutils para binutils
   • RHEL: sudo yum install git binutils
   • (aberto-)SUSE: sudo zypper in git binutils

4. Instale o código do Visual Studio. Você pode obtê-lo daqui

5. Instale o Qt. Você pode obtê-lo daqui

6. Abra um terminal e digite: git clone https://github.com/Tech-FZ/EmuGUI.git

7. Como você já está com o terminal aberto, instale (lib)xcb-cursor0. Comandos para isso podem ser encontrados em Instalação (Linux).

8. Abra o Visual Studio Code nessa pasta.

9. Abra o Anaconda Navigator e crie um novo ambiente virtual.

10. Abra o venv no VS Code e tente executar um script Python com ele.

11. No terminal do VS Code, digite: & pip install --upgrade pip PyInstaller PySide6 python-magic PyQt6 requests python-dateutil psutil pyqtdarktheme

12. Depois de fazer isso, execute o script main.py.

13. Para compilar o programa para usuários que não possuem Python instalado, digite: & PyInstaller --onefile emugui.py

14. Depois de terminar, copie o código para a pasta dist criada pelo PyInstaller.

15. Execute o executável na pasta dist. Se o seu antivírus o colocar em quarentena, não se preocupe, pois isso deve ser um falso positivo e restaure-o.

16. Se funcionar, divirta-se! Caso contrário, tente começar novamente a partir do número 9.

Documentação

Uma documentação do EmuGUI pode ser encontrada aqui

EmuGUI nas redes sociais

Contribuindo

Existem várias maneiras de contribuir, incluindo:

• Programação (correções de bugs, novos recursos etc.)
• Testes (sistemas operacionais, o próprio programa etc.)
• Tradução para línguas estrangeiras como alemão ou francês
• Documentação

Licença

Este projeto está licenciado sob a Licença Pública Geral GNU v3.0.