A5 SCREW CONVEYOR CALCULATION v0.91 Portable Windows Version ======================================== 1. SYSTEM REQUIREMENTS ---------------------- - Microsoft Windows 10 or Windows 11 - 64-bit Windows - No Python installation is required - Administrator rights are normally not required 2. DOWNLOAD ----------- Download the ZIP file named: A5_Screw_Conveyor_Calculation_v0.91_portable.zip from the official A5 Consultoria homepage. 3. EXTRACT THE ZIP FILE ----------------------- Do not run the program directly from inside the ZIP file. 1. Locate the downloaded ZIP file, usually in the Downloads folder. 2. Right-click the ZIP file. 3. Select "Extract All...". 4. Choose a local destination folder. Recommended locations include: C:\Users\\Documents\A5 Applications\ or C:\A5 Applications\ After extraction, the folder should contain exactly the application executable and the external bulk-material database: A5 Screw Conveyor Calculation v0.91 |-- A5 Screw Conveyor Calculation v0.91.exe `-- Bulk_Material_Table.csv Python and the Python libraries required by the application are packaged inside the executable. Bulk_Material_Table.csv is intentionally kept as a separate external data file. 4. START THE PROGRAM -------------------- Open the extracted folder and double-click: A5 Screw Conveyor Calculation v0.91.exe The application is portable and does not require installation. Important: - Keep Bulk_Material_Table.csv in the same folder as the EXE. - Do not rename or remove Bulk_Material_Table.csv. - The EXE may be copied to another folder only together with the CSV file. - No "_internal" folder is required for this distribution. A desktop shortcut may be created by right-clicking the EXE file and selecting: Send to > Desktop (create shortcut) The shortcut may be moved, but the original EXE and CSV must remain together in the application folder. 5. FIRST START AND WINDOWS SECURITY ----------------------------------- Because this is a preliminary unsigned application, Windows may display a security warning when it is opened for the first time. If Microsoft Defender SmartScreen appears: 1. Confirm that the ZIP file was downloaded from the official homepage. 2. Click "More info". 3. Verify that the displayed program name is: A5 Screw Conveyor Calculation v0.91 4. Click "Run anyway" only when the download source is trusted. If company or institutional security policies block the program, contact the local IT administrator. Do not download replacement DLL or runtime files from unofficial websites. 6. MATERIAL DATABASE AND SAVED MATERIALS ---------------------------------------- Version v0.91 is distributed with the reviewed Bulk_Material_Table.csv reference database as a separate file beside the executable. Step 1 loads the listed bulk materials and their reference properties automatically. The user may override database values or enter and save a custom material when required. Custom materials saved in the application are stored automatically in the current Windows user profile at: %LOCALAPPDATA%\A5 Screw Conveyor Calculation\Custom_Bulk_Materials.csv Typical location: C:\Users\\AppData\Local\ A5 Screw Conveyor Calculation\Custom_Bulk_Materials.csv This file is outside the portable application folder. Therefore, replacing or updating the program folder does not normally remove previously saved materials. 7. MOVING OR COPYING THE PROGRAM -------------------------------- The complete extracted folder may be copied to another local directory or USB drive. Always keep these two files together: - A5 Screw Conveyor Calculation v0.91.exe - Bulk_Material_Table.csv For best reliability, run the application from a local Windows folder rather than directly from a network location, cloud-synchronization preview, or compressed ZIP. 8. UPDATING THE PROGRAM ----------------------- When a newer version is available: 1. Close the current application. 2. Download the new ZIP file. 3. Extract it to a new folder. 4. Confirm that the EXE and Bulk_Material_Table.csv are together. 5. Run the new EXE. 6. Delete the old program folder only after confirming that the new version works. Previously saved custom materials remain in the Windows LocalAppData folder unless they are manually deleted. 9. UNINSTALLATION ----------------- The portable application does not create a conventional Windows installation. To remove it: 1. Close the application. 2. Delete the extracted program folder. To also remove saved custom materials, delete: %LOCALAPPDATA%\A5 Screw Conveyor Calculation\ Deleting this folder permanently removes the user's saved custom-material database. 10. TROUBLESHOOTING ------------------- Reference material list is not available: - Confirm that Bulk_Material_Table.csv is in the same folder as the EXE. - Confirm that the filename is exactly Bulk_Material_Table.csv. - Re-extract the complete ZIP if the CSV was removed, renamed or quarantined. - The program can still fall back to manual material entry, but the distributed v0.91 package is intended to include the reviewed reference database. Program does not start: - Confirm that the ZIP was fully extracted. - Try moving the complete extracted folder to Documents or another local folder. - Check Windows Security > Virus & threat protection > Protection history. - Re-download the ZIP from the official homepage if files may be incomplete. Program opens but the material database is unavailable: - Confirm that the EXE and Bulk_Material_Table.csv are in the same directory. - Do not place the CSV inside a subfolder. - Re-extract the original ZIP if necessary. Program opens from one computer but not another: - Confirm that the second computer uses 64-bit Windows 10 or Windows 11. - Confirm that antivirus software has not quarantined the executable. - Contact the local IT administrator if execution is restricted. 11. SOFTWARE SCOPE ------------------ A5 Screw Conveyor Calculation v0.91 is intended for preliminary engineering calculations and evaluation. It does not replace: - detailed mechanical design; - manufacturer verification; - fabrication drawings; - structural assessment; - machinery-safety analysis; - professional engineering approval. Final equipment selection and manufacture should be reviewed by a qualified engineer and the screw-conveyor manufacturer. 12. VERSION ----------- Program name: A5 Screw Conveyor Calculation Version: v0.91 Distribution type: PyInstaller one-file Windows executable with external Bulk_Material_Table.csv