Merge pull request #1 from rocksdanister/dev-build

release.

License.txt

@@ -0,0 +1,31 @@
+Microsoft Public License (Ms-PL)
+
+This license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.
+
+1. Definitions
+
+The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same meaning here as under U.S. copyright law.
+
+A "contribution" is the original software, or any additions or changes to the software.
+
+A "contributor" is any person that distributes its contribution under this license.
+
+"Licensed patents" are a contributor's patent claims that read directly on its contribution.
+
+2. Grant of Rights
+
+(A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.
+
+(B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.
+
+3. Conditions and Limitations
+
+(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
+
+(B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.
+
+(C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.
+
+(D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.
+
+(E) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.

README.md

@@ -1,34 +1,38 @@
-
-
-
 # Lively - Animated Wallpaper System
 [![GitHub release](https://img.shields.io/github/release/rocksdanister/lively/all.svg)](https://github.com/rocksdanister/lively/releases)
 [![Github all releases](https://img.shields.io/github/downloads/rocksdanister/lively/total.svg)](https://github.com/rocksdanister/lively/releases)
 
 ## Contents
-
 - [About](#about)
-- [Download](#download)
 - [Features](#features)
+- [Download](#download)
 - [Issues](#issues)
-- [Attribution](#attribution)
+- [Contributing](#contributing)
+- [Support](#support)
 - [License](#license)
 
 ## About
 ![demo-gif](/resources/preview.gif?raw=true "demo")
 
-Turn Video & GIF Files, Emulators, HTML, Web address & Shaders, Games into Windows desktop wallpaper; Software will completely pause( 0% cpu & gpu usage) when fullscreen application/games are running.
+Turn Video & GIF Files, Emulators, HTML, Web address & Shaders, Games into Windows desktop wallpaper; **Wallpapers will completely pause playback( 0% cpu & gpu usage) when fullscreen application/games are running.**
 
-Originally made this as a console application for personal use before working on my other projects "rePaper" & "GBWallpaper". Lively is still in early development.
-## Download
-##### SOON
+![demo-gif2](/resources/dragdrop.gif?raw=true "dragdrop")
 
-## Features
+Just drag & drop files, webpages to set as wallpaper..
+
+#### Join Discussions:
+* <a href="https://discord.gg/TwwtBCm">Discord group</a>
+* <a href="https://www.reddit.com/r/LivelyWallpaper/">Reddit</a>
+
+Lively is still in development, if you encounter bugs create a github Issue along with <a href="https://github.com/rocksdanister/lively/wiki/Common-Problems"> log file</a>
 
+<a href="https://github.com/rocksdanister/lively/wiki">Documentation</a>
+## Features
+*Wait a sec, preview gif clips take some time to load.*
 #### Video
-![demo-gif2](/resources/sea_extended.gif?raw=true "vlc")
+![demo-gif2](/resources/vid.gif?raw=true "video")
 
-<a href="https://www.pexels.com/video/waves-crashing-to-the-shore-1536350/">Waves</a> by Tom Fisk
+<a href="https://www.pexels.com/video/aerial-view-of-a-foggy-landscape-2547258/">Foggy Landscape</a> by Tom Fisk
 * Use external codec packs or internal windows codec.
 * Play .mp4, mkv, webm, avi, mov etc 
 * Hardware Acceleration support.
@@ -40,43 +44,83 @@ Originally made this as a console application for personal use before working on
 * Chromium Embedded Framework.
 * Load HTML file or web address as wallpaper.
 * Runs webgl, javascript .. basically anything that works on chrome.
-* Audio Reactive Wallpaper support, create wallpapers that react system audio. 
+* Audio Reactive Wallpaper support, create wallpapers that react to <a href="https://github.com/rocksdanister/lively/wiki/Web-Guide-II-:-System-Audio-Data">system audio</a>
 #### Shaders
 ![demo-gif7](/resources/shadertoy.gif?raw=true "htmlshadertoy") 
 
-<a href="https://www.shadertoy.com/view/wsl3WB">Hexagone</a> by BigWIngs
+<a href="https://www.shadertoy.com/view/lscczl">The Universe Within</a>, <a href="https://www.shadertoy.com/view/MdfBRX">The Drive Home</a> by BigWIngs
 * Run GLSL shaders in browser.
-* Shadertoy urls are supported in browser.
-#### Emulators
+* Shadertoy.com urls are supported as wallpaper.
+#### Retro Game Emulators
 ![demo-gif4](/resources/emulator.gif?raw=true "html") 
-* Emulator used currently is BizHawk, supports many retro systems: [https://github.com/TASVideos/BizHawk](https://github.com/TASVideos/BizHawk)
-* Emulator will pause when not on desktop.
+* Coming soon
 #### Games
 ![demo-gif5](/resources/unity.gif?raw=true "unity") 
 * Can launch Unity & Godot games as wallpaper.
-* Audio visualisers, 3D wallpapers etc..
+* Dynamic audio visualisers, 3D scenes..
 #### GIFs
 ![demo-gif6](/resources/gif.gif?raw=true "gif")
 
-Nyan Cat
+<a href="https://giphy.com/gifs/nyan-cat-sIIhZliB2McAo"> Nyan cat</a>
 * Make Memes/Cinemagraphs as wallpaper ... 
+#### Other Applications
+* Experimentail, works for some.
+#### & more:
+- Easy to use, Just drag & drop media files & webpages into lively window to set it as wallpaper.
+- Easy to share Lively-zip format, just drag & drop the zip file to import it into Library, use the built-in creator to make them (ensures compatibility).
+- Full Multiple monitor support, play different wallpaper per screen or span a single wallpaper across all screens.
+- Hardware accelerated video playback, with option to use external Directshow codec of your choice. ( LAV(recommended), K-Lite, Kawaii Codec..)
+- Library to browse and preview wallpapers.
+- You can use it alongside rainmeter.
+- Efficient, its a native c# wpf application with c++ calls. 
+- Fully opensource & free; no blackmagic, no features behind paywall.
+#### Regarding Performance:
+ * Wallpaper playback pauses when fullscreen application/games run on the machine (~0% cpu, gpu usage). 
+ * Optionally you can set wallpaper to only play when on desktop.
+ * Application rules: Set wallpaper playback rules based on running foreground application.(like always pause when photoshop is open etc)
+ * Based on display(multiple monitor): Pause wallpaper playback per-display(depending on which monitor fullscreen apps/games run) or all display(s).
+ * Kill wallpaper when fullscreen apps/games run(coming soon).
+ * Mute audio when not on desktop (or optionally always mute).
+
+**_I'm not officially affiliated with Unity technologies, godot, bizhawk, shadertoy;_**
+## Download
+##### Latest version: v0.3.4.0 (Windows 10, 8.1, 7 32bit)
+- [`lively_full_x86.zip`][direct-full-win32]  
+   _130MB, Web wallpaper support & some sample wallpapers included._
+
+- [`lively_lite_x86.zip`][direct-lite-win32]  
+   _5MB, No web wallpaper support._
+
+[direct-full-win32]: https://github.com/rocksdanister/lively/releases/download/v0.3.4.0/lively_full_x86.zip
+
+[direct-lite-win32]: https://github.com/rocksdanister/lively/releases/download/v0.3.4.0/lively_lite_x86.zip
+
+Unzip the file, select livelywpf.exe to get started, first run will be slow due to windows defender scanning.
+
+[Trouble Getting started? ](https://github.com/rocksdanister/lively/wiki/Getting-Started)
+
+Certain antivirus software heuristics algorithm will detect lively as a virus, this is a false positive
+**lively is fully opensource, you are free to inspect the code.**
+
+
+## Issues
+[TODO List](https://trello.com/b/rdFFxuMF/lively-wallpaper-system)
+
+## Contributing
+Code contributions are welcome, check [guidelines](https://github.com/rocksdanister/lively/wiki) for making pull request.
+
+Currently Lively is only in English, other languages are machine translated. If interested in translating: 
 
-### Other Applications
-* in the works.
+##### Related Projects
+https://github.com/rocksdanister/lively-cef
 
-**_I'm not officially affiliated with unity, godot, bizhawk, shadertoy;_**
-## Issues & roadmap
-#### Priority:-
-* Passing input to child window turned out to be not as simple as using SetForegroundWindow, currently bizhawk uses its own keyhook. Complete mouse & keyboard(optional) will need to be implemented next.
-* Unity games compiled with "run in background" disabled will pause since its not in focus, need to find a solution.
-* Tweaking Cefsharp audio reactive parameters.
-* Multimonitor is currently limited to certain types of wallpapers, more types need to be supported in multiple display systems.
-#### Not priority:-
-* Wallpaper creation tools.
+https://github.com/rocksdanister/lively-gallery
 
-## Attribution
-todo
+## Support
+You can always help development by buying me a cup of coffee(paypal):
+[![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/P5P1U8NQ)
 
 ## License
-todo
+Lively is licensed under Microsoft Public License (Ms-PL). 
+Individual license of libraries used is found in license file in the source.