Online Help
Troubleshooting
How to solve problems, eg. dealing with FTP.
Before using the software you could read Quick Start page of online help for a brief introduction.
| Installation | |
| Software does not open | See Installation in online help |
| In case of incompatibility it is recommended to use the software in a virtual machine | |
| Common issues | |
| Software crashes, freezes or does not work correctly | Report an issue on the GitHub repository at https://github.com/ctlcltd/e2-sat-editor/issues Attach a log if possible, refer to View software logs |
| Check any error message displayed | |
|
Check that the version you are using is the latest, refer to Check the version |
|
| Known issues | |
| STB reload displayed as done, even with errors | Known issue, affecting old software versions – Fixed since software version 1.8.1 |
| Stream URL is not parsed | Known issue, affecting old software versions – Fixed since software version 1.8 |
|
Check that the version you are using is the latest, refer to Check the version |
|
| Graphics issues | |
| Software, texts, dialogs, forms, buttons, icons, images, are displayed incorrectly | If you are using Linux or BSD-like, follow the next steps |
Try to run the software with the option Qt QPA platform "xcb", for example: ./e2-sat-editor -platform xcb |
|
Try to run the software discarding platform themes, for example: ./e2-sat-editor -platform xcb;wayland -platformtheme "" |
|
|
To run the right command, see Command line options chapter, on Command line page. |
|
|
Report an issue on the GitHub repository at https://github.com/ctlcltd/e2-sat-editor/issues |
|
|
Check that the version you are using is the latest, refer to Check the version |
|
| FTP | |
| FTP not connecting | Check the status bar at the window bottom corner for "FTP connected successfully." message, after press the "Connect" button – Fixed since software version 1.9 |
| Check the cables connecting the Decoder (STB) to the local network | |
| Check your local network settings | |
| Check your firewall settings | |
| Verify the connection parameters to STB in "Settings" in the Connections tab | |
| Verify that the FTP connection and login parameters are correct | |
| Try to connect via HTTP with your browser to STB at its IP address, when equipped with Webif | |
| Try to connect via FTP with an FTP client to STB at its IP address | |
| Attempt a connection with Passive FTP, unchecking Active FTP, and viceversa | |
| Press "Connect" and "Disconnect" in quick menu to attempt an FTP connection | |
| FTP not connecting, after previous steps |
Restart the Decoder (STB) and if necessary restart the local network router |
| Repeat all "FTP not connecting" troubleshooting steps | |
| Report an issue on the GitHub repository at https://github.com/ctlcltd/e2-sat-editor/issues Attach a log if possible, refer to Enable FTP debug |
|
| FTP does not Upload or Download | Check connection parameters to the Decoder (STB) in "Settings" in the Connections tab |
| Verify the correctness of parameters in the Configuration group: Transponders, Services, Bouquets | |
| Press "Connect" and "Disconnect" in quick menu to attempt an FTP connection | |
| Note: the software does not currently Upload/Download picon images, they should be uploaded manually to the STB | |
| Errors occurred during STB reload operations | Check if the channel list has been updated. If not, follow the next steps |
| Try to "Upload" again, sometime Webif reload and Telnet reload fail, or timeout has reached | |
| Timeout parameters are changeable from Settings, Advanced tab, ftpcom.[parameter] preference, set 0 to no timeout | |
| Sometime Telnet reload fails. Note: several STB models require root to reload from Telnet | |
| Verify the correctness of parameters for your STB model and follow the above steps | |
| Decoder (STB) does not update the channel list | Try to restart the STB manually, or if you have the specific parameters for your STB, follow the next steps |
| Edit the parameters in the Commands group, in "Settings" in the Connections tab | |
| Enter the specific parameters for updating the STB: paths, Webif reload URL address and/or Telnet reload command | |
|
Check that the version you are using is the latest, refer to Check the version |
|
| File | |
| File does not open | Check the error messages displayed |
| Verify the compatibility of the channel list file | |
| Verify read file permissions | |
| File not saved | Check the error messages displayed |
| Verify the compatibility of the channel list file | |
| Verify write and read file permissions | |
| CSV / spreadsheet | |
| CSV file not imported | Verify CSV tabular structure has not been altered |
| Make sure each row has the same number of columns | |
| Contents of clipboard not pasted | Verify TSV tabular structure has not been altered |
| Make sure each row has the same number of columns | |
|
Check that the version you are using is the latest, refer to Check the version |
|
Check the version
Check that the version you are using is the most recent.
To manually check for updates, click on Help > Check for updates.
From main menu, click menu Help > About e2 SAT Editor
Check the version number and on the Releases page of the GitHub repository at https://github.com/ctlcltd/e2-sat-editor/release for more recent updates.
With distributed installation on Linux (Snap Store, Flathub, Arch AUR), check for updates and upgrade from the software store util.
To manually upgrade package (Snap Store, Flathub, Arch AUR), see Update page of online help.
Note: Check for updates will connect to GitHub servers to the repository address, host name: github.com
The feature Do Not Track is used, but there is no warranty it will be applied.
The preference "Check for updates on launch" is turned off by default.
Enable FTP debug
FTP debugging is disabled by default to avoid slowing down execution.
It can be useful to solve problems and report issues on the GitHub repository at https://github.com/ctlcltd/e2-sat-editor/release
Recommendation: Do not do this if you do not understand what you are doing.
To enable FTP debugging, go to "Settings" > Advanced > [confirm].
In the editable table, double-click on the cell to edit the preference value.
Change the ftpcom.debug preference from FALSE to TRUE, typing true.
Save your settings by pressing "Save" button and close the software.
Open a terminal window and launch the software – from its current location, eg. cd e2-sat-editor-directory –
Windows PowerShell $env:QT_WIN_DEBUG_CONSOLE="new"; .\e2-sat-editor.exe
Windows CMD e2-sat-editor.exe 2>&1 > log.txt
macOS ./e2\ SAT\ Editor.app/Contents/MacOS/e2\ SAT\ Editor
Linux (AppImage) ./e2-sat-editor-VERSION-x86_64-linux.AppImage
Linux (Snap) snap run e2-sat-editor
Linux (Flatpak) flatpak run io.github.ctlcltd.e2se
Other shell ./e2-sat-editor
After launched the software from the terminal.
Press "Connect" and "Disconnect" from quick menu to attempt an FTP connection.
All FTP messages will be shown in the terminal.
To attach the log to the issue, select all the output and Copy, Paste to a plain text file.
Next, disable FTP debugging, change the ftpcom.debug preference from TRUE to FALSE again, typing false.
View software logs
The software creates a log in memory.
It can be useful to solve problems and report issues on the GitHub repository at https://github.com/ctlcltd/e2-sat-editor/issues
To show the log, open Inspector.
From main menu, click menu Tools > Log Inspector
From bottom toolbar, click menu Tools > Log Inspector
The log of the current execution will be shown in the dialog.
To attach the log to the issue, select all the text and Copy, Paste into a plain text file.
Log Inspector is dockable on every tabs and is persistent across all tabs.
Software logs are available also using the debugging command line option, see Command line page of online help.
Reset settings
The software can be reset to factory settings.
All settings previously saved will be erased.
Recommendation: Do not do this if you do not understand what you are doing.
To reset to factory settings, go to "Settings" > Advanced > [confirm].
In the editable table, double-click on the cell to edit the preference value.
Change the settings.reset preference from FALSE to TRUE, typing true.
Save your settings by pressing "Save" button and close the software.
The next time the software is opened it will be reset to factory defaults.