!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!(To open the Auction House Stalker, you need to install TouchDesigner. Accounts and the app are free, and the minimal installation works fine https://derivative.ca/download)!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


###Starting out:
 - To open, extract the .zip file you downloaded if you have not already, & double click the Auction House Stalker file. (TouchDesigner required)
 * Instructions to install TouchDesigner at the BOTTOM
 * Ensure all of the other files that came in the .zip download are extracted into the same folder together, as they're part of the functionality.
 * You can extract the downloaded .zip and run the app from anywhere as long as their contents are together. ( c: I run it from a folder on my desktop )


###Adding Items:
 - Go to https://na.mabibase.com/tools/auction-house and search for the item you want to stalk. Copy the **item ID** from the results.
 - (Item IDs are used over keywords due to the fact that searches like "Wool" can return results that are not bundles of wool, but simply have it as part of the item name. ItemIDs always return specific items.)
 - Click the flashing (Add) button in the top left and paste the ID into the field
 - Give the entry a name, whatever you'd like.
 - Set a "Buying" and "Selling" price to:
	a.) Set where the Red/Green lines on the price history graph will be placed
	b.) Set the price thresholds for pop-up alerts, if enabled
	TIP) You can use commas freely in any gold/price number field. It will not effect the program's results.
 - Pick if you want alerts to be enabled or not during creation. You can change this at any time later for each item separately.
 - Mark the item as a 'favorite' with the Star to ensure the program automatically updates the live prices for AH listings.
 - Add more items as needed


###Understanding how auto-searches work:
 - You can add 'favorite' items which will keep prices up to date and use alerts, if enabled, when prices fall within your buying or selling ranges.
 - The search interval is automatically set based on how many item IDs you have listed in the app.
 - Mabibase updates listings/prices at an interval of approx. 5 minutes.
 - By default, the app should ensure you get at least one sample of each update interval for every 'favorite' item.
 - You can speed up or slow down this automatically set value in the app options.
 * (Rate Limit: 1 auto-search every 10 seconds; please respect Mabibase and do not bypass this limit to spam requests)
 - At the bottom of the app is a UI element which will show if Mabibase is returning good, fresh data or if the data is old and not being updated.
 - Searches should automatically stop when detecting old data & searches should also resume automatically when Mabibase comes back online.


###Understanding the Export/Import feature:
 - As you use the app over time, there will likely be an update released. When you download the new update, it will not contain the search data you've accumilated over time in the older version.
 - To carry over your old price history and active search listings, use the "Export Listings" button in the Options to save the logs of all items tracked into a "/logs/" folder where the old AHStalker is running from.
 - Copy the /logs/ folder to your new Auction House Stalker folder, start the new version, and select the "Import Listings" button in the Options.
 - This process should allow you to keep your search data between updates, or share your price history with other users.



###Some other stuff:
 - If an item is added but not marked as a 'favorite', it will be added to the lower section of the app where the current listings/prices updates must be manually triggered.
 - This is good for items you just want to check in on every now and then instead of giving them a spot in line for the auto-searches.

 - When removing/deleting an item from searches, the price history should still be saved within the app and should return if the item is readded.
 - Use the Export/Import feature to carry price data between updates or back up your price history.

 - Use the [?] button to view a quick visual tutorial

 - Pick your settings/options in the cog wheel icon

 - Read the tooltips that appear on the bottom as you mouse around the app. You can turn these tips off in the options.

 - Use the top [X] button on the app itself to close and SAVE the items and price history.
 - Pressing [Ctrl + Q] or using the [File > Quit] menu will also correctly save and close the app data.
 - Ending the task or closing from the taskbar *Will* result in all new data generated being lost.

 - Sometimes, Mabibase stops updating with the lastest listings due to their update method disconnecting.
 - Also Sometimes, Mabibase will report that the listing data is up to date, but there have been cases where listings for specific items do not get updated while other items do.
 - In these cases, let Dani know or let the service maintainer know in the Mabibase Discord

 - Someday, I'll set up a way where the app will download and install updates automatically if the user allows it... someday.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 ! As the user base of this tool grows, so does the stress/load we add to Mabibase's servers. Please respect other people's computers and ensure you do not spam with this app. (Honor the Rate Limit)
 ! Default/Normal use of the Auction House Stalker is fine.
 ! This tool is meant to track prices over time.
 ! The quickest possible price alerts can be obtained through setting up the alert function on Mabibase itself using Webhooks. That alert is triggered by Mabibase itself and is the quickest method.
 ! Please consider supporting Mabibase, This app is useless without them: https://discord.gg/EeA6KKBQrx || https://ko-fi.com/mabibase
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 - DM Danicreates on Discord with bugs, questions, requests, etc


###Install TouchDeisnger

#1# Download TouchDesigner
Visit the official website: https://derivative.ca/
Go to the "Downloads" section.
Select the version for your operating system (Windows or macOS).
Download the installer (.exe for Windows or .dmg for macOS).

#2# Install the Program
	#For Windows#
Open the downloaded .exe file. The minimal/web installation is fine.
Follow the installation wizard instructions.
Choose the installation folder and wait for it to finish.

	#For macOS#
Open the downloaded .dmg file.
Drag the TouchDesigner icon to the Applications folder.
Close the window and eject the installer.

#3# Register and Activate
Launch TouchDesigner after installation.
Sign in with your Derivative account or create a new one at https://derivative.ca/ if you don’t have one.
Activate the Non-Commercial version (free) or use a license key if you have one. (Let's be friends if you do have a key ♥)

#4# System Requirements (Summary):
Windows 10/11 or macOS 10.14+
GPU: Graphics card supporting OpenGL 4.1 or higher (pretty much all of them)
RAM: Minimum 8 GB (16 GB recommended)
CPU: Modern Intel or AMD processor (9th Gen+ Intel or Zen2+ AMD ideally)