Update README.md

Author: fafalone

README.md

@@ -1,2 +1,49 @@
 # ShellControls
-Shell Browser and Shell Tree Controls
+## Shell Browser and Shell Tree Controls
+
+This repository contains a twinBASIC x86/x64 compatible port of my shell controls, ucShellBrowse and ucShellTree.
+
+See the original threads for a full list of all of the extensive features of these controls:
+
+[[VB6] ucShellBrowse: A modern replacement for Drive/FileList w/ extensive features](https://www.vbforums.com/showthread.php?854147-VB6-ucShellBrowse-A-modern-replacement-for-Drive-FileList-w-extensive-features)
+
+[[VB6] ucShellTree - Full-featured Shell Tree UserControl](https://www.vbforums.com/showthread.php?862137-VB6-ucShellTree-Full-featured-Shell-Tree-UserControl)
+
+### These are beta versions. 
+
+There's still some work to do in twinBASIC to complete user control support, but it's now far enough along even a massively complex control like ucShellBrowse can run. Notably, there's numerous issues with sizing and scaling. The demos included in this repository have worked around them as best I could.
+
+### Using these controls in your project
+
+The demos are all set to open and run, to set these up in your project:
+
+These projects use tbShellLib, the x64-compatible successor to oleexp.tlb written in twinBASIC. First add a reference to 'twinBASIC Shell Library' in Settings->COM Type Library / Active-X References by clicking TWINPACK PACKAGES and selecting it from the list, or manually downloading it from it's [repository](https://github.com/fafalone/tbShellLib).
+
+Then for ucShellTree, you need to import ucShellTree.twin and ucShellTree.tbcontrol. For ucShellBrowse, import ucShellBrowse.twin and ucShellBrowse.tbcontrol.
+
+### The Demos
+
+Here's the included demos in this repo:
+
+#### Basic Shell Tree Demo - tbShellTree.twinproj:
+
+![image](https://user-images.githubusercontent.com/7834493/208004027-283c2d98-aee1-4da8-8fd2-ffebd676414e.png)
+
+#### Main Shell Browser Demo - DemoMain.twinproj
+
+![image](https://user-images.githubusercontent.com/7834493/213373325-959b1f74-6280-41d6-9dcb-7a06b464b479.png)
+
+#### ucShellBrowse as an upgrade to native VB/TB controls - UCSBDemoVB.twinproj
+
+![image](https://user-images.githubusercontent.com/7834493/213373444-cfdd0e7d-74cc-48c6-95dc-63dd8beb4f25.png)
+
+#### Fully customized file open dialog - FileDialogDemo.twinproj
+
+Shows combining ucShellBrowse and ucShellTree:
+
+![image](https://user-images.githubusercontent.com/7834493/213373633-e539fc13-0287-496e-9d69-a3518a3d6327.png)
+
+
+----
+
+I'll add more in the future. Note that while due to the difference in typelib and IPAO-hooking methods, you can't directly import VB projects with these controls, you should be able to recreate any of the other screen shots.