[RELEASE] Bundle Manager - The ONLY place to find BPTWorld Bundles! Find, install and update bundles quickly and easily

bptworld · May 28, 2022, 12:17pm

Introducing 'Bundle Manager'
The place to explore BPTWorld's Bundles. Find, install and update bundles quickly and easily.

Bundles are an easier way for Developers to maintain and distribute their work. It also makes it much easier for any user to install the apps/drivers/libraries they are looking for!

Requires HE version 2.3.2.130 or above

Features:

Simple, streamlined interface
Powerful search features. Search by 'All Bundles, New Bundles (last 7 days), tags, developer, contains keywords and does not contain keywords'!
Optional automatic bundle updates
Optional Push notification when updates are available
Option to launch New App Config right after downloading the Bundle

Why create Bundle Manager, when we already have Package Manager?

Bundles make it sooo much easier for developers to create, save and distribute their work. The ability to make bundles has been out since 7/2021. The original HPM author made is very clear that he would not be adding Bundles into HPM. With that said, I started to play around with coding BM. Over the past year, he left several hints that his time with HE was coming to an end. So I picked up the pace trying to make BM work. Now as I'm sure you have noticed, HPM has officially changed hands (5/22). That was it. Time to release BM!

Edit: Well, looks like Bundles are coming to HPM (6/22). Thanks to the open mind of @csteele. That's great news for all HPM users/developers!

So where does Bundle Manager fit in!? I put a lot of time and effort into making this, so I will continue to innovate and stay on the cutting edge of what HE can do. This will be THE ONLY PLACE to find BPTWorld Apps and Drivers!

To make this a non-compete type of thing, Bundle Manager will only host BPTWorlds apps.

*** All instructions are in post #2 ***

This App can be found on my GitHub or by using the Hubitat Package Manager.

When reporting problems...

Be sure you are on the latest version. I won't troubleshoot an older version.
Turn on debug and screenshot the issue happening in the log. One line or just the error doesn't cut it. I need a log.
Post the screenshot of the log with an explanation of the problem.

Let me say that again. If you don't post a screenshot of the Debug Log, then I can't help you.

Thanks

bptworld · May 28, 2022, 12:18pm

General Usage Instructions:

Manual Install

To Manually install Bundle Manager

copy this link. https://github.com/bptworld/Hubitat/raw/master/Bundles/BundleManager.zip
From the Hubitat Main Menu, go to 'Bundles'
Click in the upper right hand corner, 'ImportZIP'
Click 'Import from a URL'
Paste in the URL
Click 'Import' and WAIT for the words 'Bundle Imported' message

Install App like any other custom app.

From the Main Menu, click 'Apps'
Click on 'Add User App'
Select 'Bundle Manager'

Have fun!

1. First Time

The First thing anyone should do, is fill out the 'General' section and then scroll down and press 'Done'
Now go back into the app and click 'Search'.
Since this is the first time Searching, be sure to use the 'Manually update Master Bundle List' switch. The switch will turn off when finished.

Note: Any BPTWorld apps that you have previously installed should be downloaded again from BM. There shouldn't be any other setup required. It will just update it to the latest version.

2. Search and Install Bundles

Use any of the Search options to find the Apps you want or use the 'Show All' or 'Show New' switches to browse.
Once you find a bundle you would like to install, simply use the drop down at the top of the page to select the Bundle.
-- Be sure to take note of any Special Requirements that any App may have listed on its tile. (ie. all BPTWorld apps require 'Normal Stuff Library' be installed first.)
-- Always download the required Bundle first. (it will warn you that it's needed, if you don't!)
Now use the 'Are you sure' switch. At this point the Bundle is being downloaded and installed. The switch will turn off when finished. Please be patient, it can take a minute or two depending on the App.
If this is the first time you install this app, you will most likely be presented with a 'Click Here to configure App'. Go ahead, click it! You will be launched into the new app.

3. Updating Bundles

BM will check periodically for updates or you can manually look for updates
If an update is found, a new button will pop up. Click it and go to the update page
Select the updates that you want to do and then click 'Update Bundles'
At this point you should get the 'Successful' message for any bundles that you choose
When finished updating, click 'Next'
That's it! You're now back to the main screen

Other Notes - IMPORTANT

If you have an app that was previously installed that isn't showing up in the 'Installed Bundle Versions'. Please use the 'Search' option and re-download the bundle. No need to remove/setup or otherwise mess with the app. Just download the bundle and it will take care of it.
If you don't see an app that you need, let me know and I'll bump that one up the list to be added.

How to Install a Bundle without BM

If you ever needed to manually install a bundle. Almost the same as following the 'Manual Install' but hey, it has a flashy title.

Click on 'bundles' in the HE menu
Click 'Import zip'
Click 'From url'
Paste in the RAW url: ie. https://github.com/bptworld/Hubitat/raw/master/Bundles/BundleManager.zip
Click 'import'
It will automatically download and install the bundle

Installing from HPM

Bundle Manager can be installed from HPM

Search for 'Bundle Manager HPM'
Follow the prompts to install
Launch BM and follow the on screen instructions to have the newest full version of BM installed

Once this is done, Bundle Manager HPM is no longer needed and can be uninstalled using HPM.

How to unmatch from HPM

Click 'Package Manager Settings' from the main menu

Scroll to the bottom of the page and click 'Remove a matched package'

Select a package and click 'Next'

Done!

Click the link below to see some screenshots!

Screenshots

bptworld · May 28, 2022, 12:18pm

(blank)

bptworld · May 28, 2022, 9:11pm

First Beta is now available! I'll be adding in my apps slowly, once I know some people are using this and everything is working correctly.

Who wants to try it!?

tony.fleisher · May 28, 2022, 9:12pm

@bptworld Looking forward to seeing where this goes. I have been hoping to get better support for bundles for a while now.

A few thoughts:

Consider adding the ability for developers to provide links to accept/direct donations
Consider using JSON lists for tags

bptworld · May 28, 2022, 9:18pm

To me, the donation links belong in each individual app. But if enough developers want it added, it's easy enough to add.
Didn't see the need for a more complicated setup. Give the Search function a test drive, it works great!

bptworld · May 29, 2022, 1:48pm

New version...

1.0.1 - Minor changes

Remember, once you have BM installed, you can update BM from within BM.

BorrisTheCat · May 29, 2022, 5:18pm

How? There is no update button? What am I missing.

Edit found it, turned off auto updates and it appeared.

bptworld · May 30, 2022, 11:03pm

Version 1.0.4

Lots of little cosmetic changes
Made some changes to the json file
Added Paypal link to each dev ( I know, it's only me, lol ) (@tony.fleisher)

dbunch304 · May 31, 2022, 12:39am

I came across this app while reading up on Device Check Plus.

I got the Bundle Manager installed and working.
Its simple and nice.

I selected Device Check Plus
and than the Install Bundle which is says it will turn off when installed.
It turns off, but the app never installs.

Am I doing something wrong?

bptworld · May 31, 2022, 12:51am

After installing the bundle, did you go to the 'Apps' page and click the 'Add User App' button? This has to be done with any user app. Other than that, I would need to see a screenshot of a debug log.

Thanks

Edit: you can now launch the app config right from BM

bptworld · May 31, 2022, 12:11pm

New version,..

1.0.5 - 05/31/22 - Added Launch New App Config option

dbunch304 · May 31, 2022, 11:47pm

Yes Bundle Manager is installed and is in my app list.
I just removed it and installed 1.05.

I have attached a log.

I click on the Choose Bundle to install drop down and choose Device Check Plus.
I click on Install Bunch and the button Turns Blue(on) and than off.

I than Click on "Click Here" and it gives me an Error 500.
I've provided some screen shots..

I got the logs from the main Log file for Hubitat and chose to show only Bundle Manager.

bptworld · June 1, 2022, 12:20am

No need to 'remove' apps, just update or re-download them.

I see your doing this on your phone. What happens when you use Chrome?

dbunch304 · June 1, 2022, 12:41am

Same 500 error

I also tried rebooting the hub.

bptworld · June 1, 2022, 12:45am

I just uploaded 1.0.6 with some more logging. Please update and take another debug log.

Thanks

dbunch304 · June 1, 2022, 12:58am

Updated to 1.06
Did the install and after it was done the button went from blue to grey and I got this message.

app:8082022-05-31 20:56:39.790 debugIn searchOptions - Getting app ID: null

app:8082022-05-31 20:56:39.535 debugIn getAppsList - Getting installed Apps list

app:8082022-05-31 20:56:39.533 debugIn searchOptions - prevInstalled: false

app:8082022-05-31 20:56:39.525 debugIn installBundleHandler - Finished

app:8082022-05-31 20:56:39.522 debugIn installBundleHandler - Receiving file: https://github.com/bptworld/Hubitat/raw/master/Bundles/DeviceCheckPlus.zip

app:8082022-05-31 20:56:37.368 debugIn installBundleHandler - Getting data ([uri:http://127.0.0.1:8080/bundle/uploadZipFromUrl, headers:[Accept:/, ContentType:text/plain; charset=utf-8, Cookie:null], body:{"url":"https://github.com/bptworld/Hubitat/raw/master/Bundles/DeviceCheckPlus.zip","installer":null,"pwd":""}, timeout:90, ignoreSSLIssues:true])

app:8082022-05-31 20:56:37.365 debugIn searchOptions - Sending to installBundleHandler: https://github.com/bptworld/Hubitat/raw/master/Bundles/DeviceCheckPlus.zip

app:8082022-05-31 20:56:37.362 debug*

app:8082022-05-31 20:56:37.359 debug*************** End findBundles ***************

app:8082022-05-31 20:56:37.353 debug------------------------------ End - Error Monitor ------------------------------

app:8082022-05-31 20:56:37.350 debugIn findBundles - matchedCount: 1 - VS - countToReach: 1

app:8082022-05-31 20:56:37.347 debug*************** Start - PayPal.Me ***************

app:8082022-05-31 20:56:37.345 debug------------------------------ End - Averaging Plus ------------------------------

app:8082022-05-31 20:56:37.342 debugIn findBundles - matchedCount: 1 - VS - countToReach: 1

bptworld · June 1, 2022, 1:28am

@dbunch304
Curious, what Platform version are you using and what Hardware?

Thanks

bptworld · June 1, 2022, 1:45am

thanks,

I can't reproduce it here, it's working just fine. Anyone else NOT in the beta program try this? Just wondering if this is the difference. (all mine are in the beta)

Anyway please try 1.0.7 and post a screenshot of the debug log. Please please please use a screenshot of the log.

bptworld · June 1, 2022, 2:18am

I just downgraded one of my hubs and ... it doesn't work.

Will have to look into it tomorrow.