@@ -57,12 +57,36 @@ flatpak-builder --user --force-clean --install-deps-from=flathub build-dir io.gi
5757flatpak run io.github.BuddySirJava.SSH-Studio
5858``` 
5959
60+ 
61+ ## Troubleshooting Flatpak Sandbox  
62+ 
63+ If "Test SSH Connection" fails, grant the sandbox the Flatpak talk permission:
64+ 
65+ ``` bash 
66+ flatpak override --user --talk-name=org.freedesktop.Flatpak io.github.BuddySirJava.SSH-Studio
67+ flatpak run io.github.BuddySirJava.SSH-Studio
68+ ``` 
69+ 
70+ ### Finding Your App ID  
71+ 
72+ If you're unsure of your app ID, list installed Flatpak apps:
73+ 
74+ ``` bash 
75+ flatpak list
76+ ``` 
77+ 
78+ Then use the correct app ID with the override command. For example, if you have VS Code installed:
79+ 
80+ ``` bash 
81+ flatpak override --user --talk-name=org.freedesktop.Flatpak com.visualstudio.code
82+ ``` 
83+ 
6084--- 
6185
6286## Project structure  
6387
6488-  ` src/ssh_config_parser.py `  → Parse/validate/generate SSH config safely.
65- -  ` src/ui/ `  → Main App Components (` MainWindow ` , ` HostList ` , ` HostEditor ` , ` SearchBar ` , ` PreferencesDialog ` , ` TestConnectionDialog ` , ` SSH Key Manager ` ).
89+ -  ` src/ui/ `  → Main App Components (` MainWindow ` , ` HostList ` , ` HostEditor ` , ` SearchBar ` , ` PreferencesDialog ` , ` TestConnectionDialog ` , ` SSH Key Manager ` ,  ` Welcome View ` ).
6690-  ` data/ui/*.ui `  → GTK Builder UI blueprints.
6791-  ` data/ssh-studio.gresource.xml `  → GResource manifest.
6892-  ` data/media/ `  → App icon and screenshots.
@@ -113,42 +137,3 @@ See [LICENSE](LICENSE) for details.
113137
114138-  [ Open an issue] ( https://github.com/BuddySirJava/SSH-Studio/issues )  on GitHub.  
115139-  Check [ Flathub page] ( https://flathub.org/en/apps/io.github.BuddySirJava.SSH-Studio ) .  
116- 
117- ## Troubleshooting Flatpak Sandbox  
118- 
119- If “Test SSH Connection” still fails, grant the sandbox the Flatpak talk permission:
120- 
121- ``` bash 
122- flatpak override --user --talk-name=org.freedesktop.Flatpak com.buddysirjava.ssh-studio
123- flatpak run com.buddysirjava.ssh-studio
124- ``` 
125- 
126- 3 .  Save the file.
127- --- 
128- 
129- ## 5. Verify the Fix  
130- 
131- 1 .  ** Rebuild & reinstall**  with your updated manifest:  
132-    ``` bash 
133-    flatpak-builder \
134-      --user \
135-      --install \
136-      --force-clean \
137-      build-dir \
138-      com.buddysirjava.ssh-studio.json
139- ``` 
140- 
141- ``` 
142- flatpak run com.buddysirjava.ssh-studio 
143- ``` 
144- 
145- ## Using flatpak app id to try and fix the issue  
146- 
147- ``` bash 
148- flatpak list
149- ``` 
150- as an example you use vscode to run these
151- ``` bash 
152- flatpak override --user --talk-name=org.freedesktop.Flatpak com.visualstudio.code 
153- ``` 
154- now run the code.
0 commit comments