43 lines
3.3 KiB
Markdown
43 lines
3.3 KiB
Markdown
# BOIIIWD
|
|
- A GUI Steam Workshop downloader for BO3 ([boiii client](https://github.com/Ezz-lol/boiii-free)) built using CustomTkinter <br>
|
|
<p float="left">
|
|
<img src="https://github.com/faroukbmiled/BOIIIWD/assets/51106560/bd7e1bc3-bdb2-4096-8e33-5041bb9eb2d9" width="800" />
|
|
<img src="https://github.com/faroukbmiled/BOIIIWD/assets/51106560/4ea5b4d4-e810-47b0-8fdb-5a68a2b117f2" width="800" />
|
|
<img src="https://github.com/faroukbmiled/BOIIIWD/assets/51106560/81998b24-2eb2-4bcf-bccb-9b4639c00a40" width="800" />
|
|
</p>
|
|
|
|
## Usage (exe):
|
|
- Run [BOIIIWD.exe](https://github.com/faroukbmiled/BOIIIWD/releases/latest/download/Release.zip) and use it (it'll ask you to download steamcmd within the app if not found)
|
|
- That's it slap in your workshop item link or just the id then hit Download and wait for it to finish, when it does just launch your game (Please check [Notes](#notes) before you ask anything)
|
|
|
|
## Usage (script):
|
|
- ```pip install -r requirements.txt```
|
|
- ```python boiiiwd.py```
|
|
- Slap in your workshop item link for example: "https://steamcommunity.com/sharedfiles/filedetails/?id=3011930738" or just the id 3011930738)
|
|
|
|
## Freezing into an exe (pyinstaller):
|
|
- ```pip install -r requirements.txt```
|
|
- ```pip install pyinstaller```
|
|
- ```pyinstaller --noconfirm --onefile --windowed --icon "ryuk.ico" --name "BOIIIWD" --ascii "boiiiwd.py" --add-data "resources;resources" --add-data "c:\<python_path>\lib\site-packages\customtkinter;customtkinter\" --add-data "c:\<python_path>\lib\site-packages\CTkMessagebox;CTkMessagebox\" --add-data "c:\<python_path>\lib\site-packages\CTkToolTip;CTkToolTip\"```
|
|
|
|
<a name="notes"></a>
|
|
### Notes:
|
|
. It saves your input except for workshop id <br>
|
|
. If you do not know where to find your map in-game check this [video](https://youtu.be/XIQjfXXlgQs?t=260) out ,for mods find "mods" in the game's main menu <br>
|
|
. Initializing SteamCMD for the first time could take some time depending on your internet speed <br>
|
|
. If the download fails when getting big maps its SteamCMD's fault, still working on a workaround <br>
|
|
|
|
. Known bugs: <br>
|
|
. Rare UI bug => instead of showing a warning message, its window goes invisible and leads to the whole ui becoming unclickable (end the task from task manager) <br>
|
|
. Possible logic bugs related to the progress bar , sometimes it carries on progressing when you pressed stop => please raise an issue if this happens often <br>
|
|
|
|
### todos:
|
|
- [x] add a menu that shows you current installed mods/maps
|
|
- [x] fix the progress bar => progress bar logic based on an estimation
|
|
- [x] other improvements regarding the download (steamcmd likes to fail sometimes for no reason) => added a way to keep looping when steamcmd crashes and it will eventually finishes
|
|
- [ ] add a queue window that you can slap in a bunch of items to download sequentially and or simultaneously
|
|
- [ ] add an option to login with your account => delayed (do we really need it?)
|
|
|
|
### Themes:
|
|
- If you choose "custom" theme a file called boiiiwd_theme.json will be created in the current folder (where the exe at) , Don't add anything or edit any keyes just modify the colours, If you mess up something you can just rename the file and it'll go back to the default theme (you can always press custom again and the file will be created again, based on which theme you choose before)
|