Example Image

---

Timeframe Sync

Is a lightweight, floating desktop widget designed for traders and financial analysts who need to track multiple timeframe countdowns and global trading sessions simultaneously. It provides real-time visual feedback of candle close times and active market sessions in a clean, always-on-top interface.

---

Create the app with pyinstaller

python3 -m venv venv

source venv/bin/activate

pip install pyinstaller

pyinstaller -F your_script.py

When done, deactivate env

deactivate

---

Linux (Ubuntu)

Install pipx first

sudo apt update

sudo apt install pipx

pipx ensurepath

Then install pyinstaller with pipx

pipx install pyinstaller

sudo apt install python3-tk

Then try the step (Create the app with pyinstaller)

---

How to Make Your Python Binary a Visible App in Ubuntu

Step 1: Create an Applications Folder

Open a terminal and create a folder for your apps:

mkdir -p ~/Applications

Move your binary file into this folder:

mv /path/to/your/binary ~/Applications/

---

Step 2: Create the App Launcher File

Create a .desktop file in the right location:

mkdir -p ~/.local/share/applications
nano ~/.local/share/applications/myapp.desktop

Copy and paste this template into the editor:

[Desktop Entry]
Type=Application
Name=My App
Exec=/home/YOUR_USERNAME/Applications/your-binary-name
Icon=/home/YOUR_USERNAME/Applications/icon.png
Terminal=false
Categories=Utility;

Important changes you must make:

• Replace YOUR_USERNAME with your actual username
• Replace your-binary-name with your actual file name
• Replace My App with whatever name you want to see in the menu
• If you don't have an icon, delete the Icon= line

Save and exit:

• Press Ctrl + O (save)
• Press Enter (confirm)
• Press Ctrl + X (exit)

---

Step 3: Make It Work

Make the launcher file executable:

chmod +x ~/.local/share/applications/myapp.desktop

Refresh the application menu:

update-desktop-database ~/.local/share/applications/

---

Done

Press the Super key (Windows key) and search for your app by the name you chose. It should appear just like any installed application.

---

Quick Troubleshooting

Problem	Solution
App doesn't appear in menu	Run update-desktop-database ~/.local/share/applications/ again
App appears but won't launch	Check that the Exec path in your .desktop file is the full absolute path to your binary
No icon	Either add a .png icon file to your Applications folder and set the Icon path, or delete the Icon= line entirely