<!-- thumbnail: https://i.sstatic.net/ntR70.png -->
<!-- version:  2.0.0beta3 -->
<!-- tag: roomba -->
<!-- excerpt: Will the question be Roomba'ed? If so, when? If not, why? Adds a status line to questions showing: If and when Romba will delete the question; Why it won't be deleted; If down-voting will Roomba. -->

#Roomba Forecaster (&#8202;[install](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/RoombaForecaster.user.js)&#8202;) <sub><sup>(&#8202;[GitHub][1]&#8202;)</sup></sub>

Roomba Forecaster is a user-script that shows the question's status with respect to being deleted by Roomba.

This script adds a "roomba" status line under "viewed"/"active", in the top-right of
question pages, which shows:

* If [Roomba](http://stackoverflow.com/help/roomba) will delete the question
* How long until the question is deleted
* Why the question won't be deleted (by default, displayed in a tooltip)
* If you down-voting on the question or answer(s) will qualify the question for Roomba

You can click on the "roomba" status line to open an options dialog to change display settings.


###The "roomba" status line

![Roomba Forecaster](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/larger-down-vote-question-will-roomba.png)

###Where it is on the page relative to the question

[![Roomba Forecaster location on the page](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/location-on-page-with-red-circle-660px.png)](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/location-on-page-with-red-circle.png)

##Why it won't Roomba: tooltip (default) or always visible (optional)
The reasons the question does not qualify for the three different Roomba tasks is included in a table.  The table is, by default, displayed in a tooltip when the mouse hovers over the "roomba" status line:    
![tooltip](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/tooltip.png)

Alternately, the table can be always visible by selecting the appropriate display option.

##Show if your down-vote(s) get the question Roomb'ed (default)
In addition, the default is to display if you down-voting on the question and/or answer(s) will qualify the question to be Roomba'ed.

Question  
![downvote question will roomba](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/downvote-question-will-roomba.png)

Answer(s)  
![downvote answer will roomba](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/downvote-answer-will-roomba.png)


##Number of days to deletion
If the question will be deleted by Roomba, then the number of days until it is deleted is displayed, along with if it is a daily, or weekly Roomba task. 

One Roomba task runs daily:  
![daily roomba](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/daily-20days.png)

Two Roomba tasks run weekly:<sup>1</sup>  
![weekly roomba](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/weekly-29days.png)

##Options
Clicking on the "roomba" status line will open an options dialog where you
can select what is displayed.  The following GIF shows how the display
looks with the various different options:

![Roomba Forecaster options](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/options.gif)

Clicking on the <kbd>Close</kbd> button will keep the selected options for use on this page only. <kbd>Save</kbd> will store the options for use on all pages. <kbd>Cancel</kbd> abandons any changes you have made to the options.

###Short descriptions in the status line (optional)
The optional short descriptions in the "roomba" status line are cryptic:   
![short reasons](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/short-reasons.png)

The best way to learn what they mean is to match them up against what
is displayed in the larger table (either as a tooltip, or
always displayed).  
![short reasons](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/README-assets/tooltip-short-reasons.png)

#Getting the code 

###[Install](https://github.com/makyen/StackExchange-userscripts/raw/master/Roomba-Forecaster/RoombaForecaster.user.js) from GitHub
This is a user-script, so you will need [Greasemonkey, or Tampermonkey][3].

###The source code is on [GitHub][1]
Please file any issues there

##Contact
You can contact me through Stack Exchange comments or chat. Alternately, through filing issues on GitHub.

##Browsers
Roomba Forecaster has been tested on Chrome, Firefox, Opera, and Edge. It should be compatible with other browsers.

##Compatibility Notes
The tooltip is styled to look like a native tooltip in the browsers which were tested: Chrome, Firefox, Opera, and Edge. Thus, the tooltip will look slightly different in in each browser. The images above are from Chrome. 

##License
Roomba Forecaster's code is released under [CC BY-SA 4.0][4], the international version of the license used for all contributions to Stack Exchange.

----------------------------
<sup>1.  Actually, four Roomba tasks run weekly.  The other two only
affect questions migrated to another Stack Exchange site or from another site and rejected. While the script should detect these, the Stack Exchange system automatically forwards the page to the site where the question currently exists. Thus, unless something changes in how Stack Exchange shows such questions, it is unlikely that you will see one.</sup>

<sup>This is a fork of [RoombaForecast](https://github.com/Siguza/StackScripts/blob/master/RoombaForecast.user.js).</sup>


  [1]: https://github.com/makyen/StackExchange-userscripts/tree/master/Roomba-Forecaster
  [2]: https://i.sstatic.net/Qfmbh.png
  [3]: http://stackapps.com/tags/script/info
  [4]: https://creativecommons.org/licenses/by-sa/4.0/