Skip to content

Building from Source⚓︎

Cross-Platform Notes⚓︎

Current Platform Limitations

graph LR
    A[tkinter GUI] --> B[Cross-platform]
    C[File Operation API] --> D[Windows-only Implementation]
    D --> E[Deep System Integration]
    E --> F[Windows API Calls]
  • Although tkinter is cross-platform, the file operation API is currently implemented only for Windows.
  • macOS/Linux builds require rewriting the file operation module.
  • The current development environment is limited to Windows, and the source code only supports Windows builds.

Windows Build Requirements⚓︎

Python Version Compatibility⚓︎

OS Python Version Notes
Windows 7 ≤ 3.8 Last version supporting Win7
Windows 8/10/11 ≥ 3.7 Python 3.10+ recommended

Windows 7 Special Requirements

Due to DLL limitations in shared library linking, the last compatible Python version for Windows 7 is 3.8.

System Environment Variables Configuration⚓︎

May need manual setup before packaging

Key-Value Example
TCL_LIBRARY: tcl_library_path
TK_LIBRARY: tk_library_path
Why This Is Needed

On some systems (e.g., Windows 7), PyInstaller may fail to locate the init.tcl file, causing packaging failures.

Required Dependencies⚓︎

  • Web Processing
    beautifulsoup4 · Markdown · Requests

  • Document Processing
    chardet · openpyxl · python_docx · python_pptx · fpdf

  • Image Processing
    Pillow

  • System Tools
    psutil · watchdog · winshell · pywin32 · pystray · darkdetect

  • Packaging Tools
    pyinstaller

  • UI Enhancement
    ttkbootstrap

Build Steps⚓︎

  1. Prerequisites

    Ensure Python 3.x environment is installed

  2. Clone Repository

    git clone https://github.com/pyheight/ttk-file-explorer.git
    

  3. Navigate to Source Directory

    cd ttk-file-explorer/src
    

  4. Install Dependencies

    pip install -r requirements.txt
    
    pip install -r requirements_latest.txt
    
  5. Launch Application

    python main.py
    

  6. Package Application

    python script/package.py
    

Encountering Issue

Let's Solve It