fili 0.2.0 (pre-release)

fili 0.2.0 (pre-release)

Replace the driver of a USB device or interface on Windows (like Zadig, but scriptable), from the command line or a small graphical window. Free software, GPL-3.0-or-later.

This is a pre-release. It changes drivers and adds a self-signed certificate to the PC's trusted stores. Use it only on your own devices, first on a device you can afford to lose. No warranty.

What's new since 0.1.0

• fili restart (and the Restart button): enables a device that Windows shows as disabled, otherwise restarts it. Changes no driver.
• fili reinstall (and the Reinstall button) now also works on a device that uses its manufacturer's or Windows' driver: it removes the device and lets Windows detect it again. No certificate is added.
• fili update and Help > Check for updates: tell you whether a newer version is published. Only when you ask; one anonymous request to GitHub; nothing is downloaded or installed. The optional box "Check for updates at startup" is off by default. See PRIVACY.md.
• Version information (publisher, product, version) in the executables and in the installer.

Download

• fili-setup-0.2.0.exe: installer (copies fili.exe, fili-gui.exe, wdi-simple.exe to C:\Program Files\fili, Start-menu shortcuts, optional PATH entry). It changes no driver and adds no certificate.
• SHA256SUMS: check the download with Get-FileHash fili-setup-0.2.0.exe -Algorithm SHA256.

The files are not code-signed. Windows SmartScreen may show "unknown publisher" and some antivirus programs may flag executables built with PyInstaller. The checksums detect a corrupted or altered download; they are not a signature of the author. The full source is in this repository.

What was tested

On Windows 11 Pro and in a Windows Server 2022 virtual machine, with real changes to a virtual device, a built-in composite device, two identical USB network adapters and a USB flash drive: install with WinUSB, libusbK, libusb-win32 and usbser, reinstall, restore, certificate removal, identical devices (only the selected one changes), running without administrator, protected classes, failing wdi-simple, Secure Boot on, hung drivers (usb-reset).

Not verified

restart and reinstall of a manufacturer's driver on real hardware (only previews and automated tests so far), Windows 10, Memory Integrity, --wcid on a device that advertises WCID, ARM64 and 32-bit Windows, code signing. --filter is not supported on network adapters.

Notes

• Requires administrator for any change. Protected classes (keyboard, mouse, disk, Bluetooth) are refused without --force.
• The graphical interface is in English.
• Third-party components: libwdi (LGPL), libusb-win32, libusbK; licenses and sources are in the LICENSES and THIRD_PARTY folders of the installation.

---

fili 0.2.0 (versione di prova)

Sostituisce il driver di un dispositivo o di un'interfaccia USB su Windows (come Zadig, ma scriptabile), da riga di comando o con una piccola finestra. Software libero, GPL-3.0-or-later.

È una versione di prova. Cambia driver e aggiunge un certificato autofirmato agli archivi attendibili del PC. Da usare solo su dispositivi propri, prima su uno sacrificabile. Nessuna garanzia.

Novità rispetto alla 0.1.0

• fili restart (e il pulsante Restart): riattiva un dispositivo disattivato da Windows, altrimenti lo riavvia. Non cambia driver.
• fili reinstall (e il pulsante Reinstall) ora funziona anche con il driver del produttore o di Windows: toglie il dispositivo e lo fa rilevare di nuovo. Non aggiunge certificati.
• fili update e Help > Check for updates: dicono se è stata pubblicata una versione più recente. Solo su richiesta; una richiesta anonima a GitHub; non scarica né installa nulla. La casella facoltativa «Check for updates at startup» è spenta di default. Vedi PRIVACY.md.
• Informazioni di versione (editore, prodotto, versione) negli eseguibili e nell'installer.

Scarica

• fili-setup-0.2.0.exe: installer (copia fili.exe, fili-gui.exe e wdi-simple.exe in C:\Program Files\fili, collegamenti nel menu Start, voce nel PATH facoltativa). Non cambia driver né certificati.
• SHA256SUMS: controlla il download con Get-FileHash fili-setup-0.2.0.exe -Algorithm SHA256.

I file non sono firmati. SmartScreen può mostrare "editore sconosciuto" e alcuni antivirus possono segnalare gli eseguibili creati con PyInstaller. Gli hash rilevano un download corrotto o alterato, non sono una firma dell'autore. Il codice sorgente completo è in questo repository.

Cosa è stato provato

Su Windows 11 Pro e in una macchina virtuale Windows Server 2022, con modifiche reali su un dispositivo virtuale, un dispositivo composito integrato, due adattatori di rete USB identici e una chiavetta USB: installazione con WinUSB, libusbK, libusb-win32 e usbser, reinstallazione, ripristino, rimozione dei certificati, dispositivi identici (cambia solo quello scelto), esecuzione senza amministratore, classi protette, wdi-simple che fallisce, Secure Boot attivo, driver bloccati (usb-reset).

Non verificato

restart e reinstall del driver del produttore su hardware reale (finora solo anteprime e test automatici), Windows 10, Memory Integrity, --wcid su un dispositivo che dichiara il WCID, Windows ARM64 e a 32 bit, firma del codice. --filter non è supportato sulle schede di rete.

Note

• Ogni modifica richiede l'amministratore. Le classi protette (tastiera, mouse, disco, Bluetooth) sono rifiutate senza --force.
• L'interfaccia grafica è in inglese.
• Componenti di terzi: libwdi (LGPL), libusb-win32, libusbK; licenze e sorgenti sono nelle cartelle LICENSES e THIRD_PARTY dell'installazione.