Version 0.1 Developer Preview 1 #94
DrewNaylor
announced in
Versions
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
Retiled Version 0.1 Developer Preview 1 Changelog
Released on 12/12/2021 (MM/DD/YYYY).
After eight months of work and an entire rewrite, Retiled is ready for its first pre-release at version 0.1 Developer Preview 1! Couldn't have done it without Microsoft's documentation on how Windows Phone looks and behaves, PySide6 and Qt, PyYAML, the wp-metro font, and Open Sans. This project wouldn't even exist without Windows Phone existing first, as the UI is meant to resemble Windows Phone. Please be sure to read the Readme included with Retiled or online as it has important info. Also refer to the System Requirements.
Please note that this version doesn't yet support running as its own environment, so you'll have to run it in something else. Plasma Mobile is recommended, as both Retiled and Plasma use Qt.
If you are reading this in Notepad or another text editor, it displays best in Word Wrap view. Click on Format>Word Wrap on the top bar. Notepad++ users will find it under View>Word Wrap. Word Wrap is automatically done if viewing on GitHub.
Hashes
MD5 checksums/hashes are not used for Retiled as they are weaker than SHA-256. More details, though they're not as relevant to Retiled:
You can use sha256sum to confirm the hash of the files by running
"find . -type f -exec sha256sum {} ;" in the folder you extracted the archive to and comparing the output to my sums listed below. Be sure that you don't copy the quotes. Hopefully this'll work on non-Bash systems, like postmarketOS. I got this command from this Ask Ubuntu answer: https://askubuntu.com/a/486094 . HowToGeek has a nice article on checksums and stuff:
https://www.howtogeek.com/67241/htg-explains-what-are-md5-sha-1-hashes-and-how-do-i-check-them/ .
Please wait...
Features
Instead of a standard changelog, I'm going to list some features of Retiled.
How to Use
This is a more detailed guide on how to use Retiled than the brief features list above. Some content may be repeated toward the last few steps.
Extract the "retiled_v0.1-DP1.zip" archive to a folder. No package currently exists, though I'd like to make one.
Open a terminal in the root of the newly-extracted archive.
Run "sh ./Scripts/install-retiled.sh" to begin the installation process. You will be prompted for your password after Python pre-compiles the scripts for installation.
If you'd like to uninstall Retiled, you can run "sh Scripts/uninstall-retiled.sh" and it'll delete the installed files after asking for your password if it's been long enough. Please be aware that any user-made files in "/opt/Retiled" will be deleted, as that's how the uninstall process works right now. Config files in "~/.config/Retiled" will be kept.
Once you type in your password, the installer will create a directory in "/opt/Retiled", then it'll copy the main files there, the .desktop files to "/usr/share/applications", and scripts to run things to "/usr/bin". This may take a bit, though the pre-compilation may take longer.
Once you return to the prompt, Retiled should be installed, and you can launch RetiledStart and RetiledSearch from your mobile environment's apps list. Plasma Mobile might not properly reload and display the new files, so you may have to restart your phone. You can also run "retiledstart" and "retiledsearch" from the terminal, if you want. That's useful if you're having trouble running them, as any errors or packages that are missing should be displayed.
If running RetiledStart, you can pin apps from the All Apps list by long-pressing on the app's name and tapping "pin to start", resize tiles by long-pressing on a tile then tapping the resize button in the bottom-right corner until you're happy with the size (cycling through medium->small->wide->medium), and unpin tiles by long-pressing on a tile then tapping the unpin button in the top-right corner. Once you long-press a tile, you enter "global edit mode", which allows you to tap other tiles to move the edit buttons to that tile. Exiting global edit mode is done by tapping a tile with edit buttons on it (tiles with edit buttons on them are in "local edit mode"). Exiting global edit mode is required to save your layout changes.
Just to make sure no one misses it, you have to save your tile layout/size changes by exiting global edit mode, which is done by tapping a tile that has edit buttons on it. Pinning a tile automatically saves the tile to the config file.
With RetiledSearch, just tap the textbox and the touch keyboard should show up, allowing you to enter a search term. Pressing "Enter" or tapping "search" will open the Bing search results for the term you entered in your default browser.
Tip: Since moving tiles around isn't supported yet, you can manually change which app is assigned to any pinned tile by opening the config file ("~/.config/Retiled/RetiledStart/startlayout-modified.yaml") after doing anything that forces a save (entering global edit mode and resizing a tile from medium to medium won't cause the file to be saved, to reduce eMMC writes; this is also the reason why you have to exit global edit mode for changes to be saved). Once it's open in your text editor, change any of the .desktop filenames to the app you want that tile to be for. Please note that currently only .desktop files in "/usr/share/applications" are accessed. You'll have to restart RetiledStart for your changes to show up.
Known Issues
Please note that these known issues may not be recorded in the issue tracker, so they won't show up at the link below.
See all known issues: known issue
This discussion was created from the release Version 0.1 Developer Preview 1.
Beta Was this translation helpful? Give feedback.
All reactions