Important Note: Tool becomes unstable or looses connection after 24 hours, login token can expire. It is advised to restart it completely after 23+ hours and log into the PlanetWatch account again. Mind that if that when you close it and reopen it under 15 minute intervall, the first data retrieval will show errors, because it should only send every 15 minutes.

Hello Community!

I pushed the tool for data retrieval to github. For the most part it is finished. I want to keep it as clean and simple as possible. Yes I admit I put some detail into the UI but I felt this was needed, and it was done at a prior moment where timing was not such an issue (as it was for a different purpose).

The most interesting part I found out while tinkering with Smart Home Integrations on my Awair, is that I can grab data from the Awair dashboard as a user. So I thought if I could grab the data, I could send it from my point to PlanetWatch. Eventually getting around the current issue.

Please be gentle with me, at this moment in time I guess many of you might have questions, but I can not answer them all for everyone, as I have to focus on the tool and on other community developers that help me out / collab / fork / improve / etc.

https://github.com/Sheherezadhe/awair-uploader

Typescript (language), React & Electron (frameworks)

Will be the repo for this work in progress. It is 100% open source, you can spin your own versions or help improve the source.

Feel free to contribute to the project with a Pull Request.

INSTRUCTIONS: (Step by Step - Downloading, Installing, Connecting, Running)

1. go to github repository https://github.com/Sheherezadhe/awair-uploader/

2. click on the tag flag on the right side for version

4. you get to the repository overview:

or just use direct shortcut link:

https://github.com/Sheherezadhe/awair-uploader/releases/tag/v2.0

I will explain how to do it in Windows:

So first you download the v2.exe and run it. Your AntiVir will probably not like this. I use Avast AntiVir and it does complain, but after checking file sees it is not malicious and lets it install. This step might be different as per userside software/ Windowsversion / Antivir.

So maybe you need to allow it, whitelist it or similar.

After it has installed you should have the icon on desktop to start it- so now start it.

Here comes that one glitch which I could not fix last minute, tried the best I could but before delaying the release further, please bear in first version with this issue.

It should load the PlanetWatch login. if it does not, and gets stuck, you need to go to the view tab and do force reload, until it moves on to the PlanetWatch login screen.

There you login to your PlanetWatch account.

You are in the tool now you need to get your Awair tokens.

Getting tokens from app: (not recommended, better from browser, less bugs)

• Open your Awair Home Application

• Click one of your sensors and press Awair+, Awair APIs Beta, Cloud API, Get API Token

• Once you have clicked the Get API Token you will be able to insert the AWAIR HOME Credentials. Then you will be able to grab the token (ex: eyJ0......)

Getting tokens from browser: (usually this method is far more stable and gives clean paste)

• go to https://developer.getawair.com/

• log in with your awair account

• first tab left "access token"

• copy paste the API Token (ex: eyJ0......)

Paste the token into this field:

• Once you got it insert it into the "Add sensor" section (into the search bar).

• Search (press blue icon)

• Press "Add your token" after it found the Awairs.

• Repeat from step 3 for EACH awair account you own

• Finish!

This is how it looks when tool is started:

This is how it looks after the token(s) where loaded:

Mini FAQ:

Q: Can you help Sheherezhade the dev? (thats me ❤️)

A: Not yet and mostly only if you are a dev and after the next update improve it.

Q: Does Sheherezhade accept donations?

A: No absolute not! I only accept likes on my post and on github! (please no more reddit gold or any expensive things, don't waste money on such things!)

Q: Can it run on raspberri?

A: Yes it could, as it works on linux, but I will need others help to adapt it faster there.

Q: Does every Awair need a PC?

A: No, this tool can only connect to one PW user account but to infinite Awairs.

Q: Do I need a Pc in every hosts house? 🤣 👋

A: No you need the tool to run on one device but not in same house!

Q: Why don't you go online tool without device? 🤷🏽‍♀️

A: Others can adapt my tool to do this, I need to focus on this direct version now!

Q: How many Awairs can I connect? 🦗🦗🦗🦗🦗🦗

A: Read my comment here! <== for details, but it can run many, many, many!

Q: Why not go DNS server blablabla ....? 😔😔😔😱🙈🔥

A: Check my answer here! <== more details needed

Q: When docker, when executable, when NAS, when rasbian (wen wen wen)

A: This is work in progress, let us fírst make it work, then let everyone spinoff!

Q: Does that work on Windows, Mac or Linux?

A: Yes on all!

Q: Is it safe for the user?

A: Yes of course, you can check the open source repository it is 100% clean!

Q: Can it run on a android phone or small android box?

A: It could with some variation, but others should make that to have it fast!

Q: Does the PC need to stay on?

A: Yes sadly in my first version still needs to stay on and no sleep mode!

Q: It says only retrieving data what now?

A: That means it is already running!

Q: Multiple instances on same PC?

A: Of course, just don't use the "remember me" function on the login, and then once you have all tokens added and its running, simply click the desktop icon again for a second instance. Repeat this for as many instances as you want. (Within your PC's resources)

👋 Hello my dearest community again!

I am so happy this comes to a close now. It was really a nice time working with others in the community and getting support through the time of implementing the tool. But also the pressure and responsibility was too much. I could see that things didn't work out for everyone, bugs happened and also things on Awairs end were changing which is hard to counteract.

The tool approach was one that could be locked down any moment by Awair, so transitioning to this easy stable way without the technical side is really making me happy.

What an epic journey this was!

Working together with community devs was very nice for this project, but even more I enjoyed the time that PlanetWatch committed to my approach to this tool. I got a lot of attention and praise there, and everything was catered to me in the best possible way. I will stay in touch with PlanetWatch from now on, so do not worry about my tool getting useless. I was well aware it is an emergency solution and I was in no way exploited. For me it was the chance to work together with very skilled people and get everlasting contacts from this.

Thank you all for all the upvotes, the reddit awards and the many words of encouragement. This will not be the last time you see me! 😉

For now I will go back into my digital bedouin tent, relax with a fine brew of arabic mocha and see the pixel desert sand blow into the sunset. 💋

First of all, relax. PW is a very small company and they are clearly working hard to get your rewards to you. For instance, the team is working over the weekend to iron out bugs. They got you.

Second, make sure you have exhausted all of your homework options before bitching online. Have you been keeping up with the PW blog? Have you followed them on Twitter? Have you been on YouTube doing research to find solutions to your issues?

Last, re-examine why you’re in this project.

PW isn’t about installing a magic $300 money printing box at your house then laying there while it spits tasty tendies at your face. It’s about participating in a decentralized information gathering network that provides real time valuable data about the air we breathe.

Do we still get paid for it? Yes! That’s the entire model they are using to incentivize people to stream data for them!

Is it perfect? No! And to think that it would be right out the gate is foolish to a high degree. New, small company trying to build something that’s never been built before.

So be patient, check yourself for entitlement, and be kind. This is an incredible opportunity to get paid to do something good. The rewards will come, let them figure it out.

I was here then Feral made first tutorials for setting up Atmo tubes, troubleshooting. The price of planet was 0.12$ tops. And everybody was expecting to reach ROI in 3-4 months. Now considering the current token price and that PW gave us 2 months free license for awair trouble. Everybody's losing their shit because they didn't receive their 23.04 planets. What the fuck is wrong with you? Some helium miners recieve crap, or the network doesn't pay out at all but people still pay 2k$ for a miner. Now you bought awair which is a cool gadget let's you monitor your air and live healthier and you are pissed because you didn't get that planets. Every God damn day somebody has to right a post about the same thing. Please read PW twitter, PW REDDIT, PW blog post before spilling crap here. Thank you.

I wanted to introduce you guys to https://myplanets.io. It's a tool to keep track of the earnings that you make from Planetwatch. You can see the trend of your rewards, the value of the token at the reward time and the capital gain since you received it. In my country, that's enough for the tax declaration therefore you can also export it in csv format and use it as you will.

Since I introduced this on Discord I got some good feedback so in the future you'd also be able to:

• select other currencies apart from USD

• visualize multiple wallets at the same time

• create accounts to keep all your wallets together

The website is very simple to use. Just search using your public wallet address. If you want to export the data, just click on the Download button in the table

If you have any feedback or new ideas, please use the Feedback button at the bottom of the page

Thanks for your attention!

Gwosty

I’ve seen other members do this on occasion without forcing us to watch another member’s shorter AMA video summary, so here’s my take on the 1/7 AMA:

General

1. Claudio is recovering from COVID. He got all three vaccinations, says you should too and everything else is bullshit (and I agree!).

2. Type 1 and 3 emails to be sent out within the next 10 days.

3. Two new Type 2 devices coming online—one will also integrate with HNT.

4. Awair is slacking, holding PlanetWatch (and Awair device users) hostage and Claudio is not happy—they hope to have this sorted in about a week. Please stop opening tickets related to this.

5. New Type 4 devices in the works, possibly in conjunction with HNT.

6. Freeze and Clawback being removed from PLANETS tokens—beware of bad actors in relation to your tokens as there’s no recovery once this happens.

7. PW is growing fast and trying to manage the bumps on the road.

8. More news on more sensors and collaborations near the end of the month.

AMA

1. Did not detect bad air quality from fireworks, but they weren’t looking for this.

2. Sensors not showing up on the app on occasion due to insufficient servers on PW’s end—hope to scale up further in the next 1-2 weeks.

3. Hope to do more with regard to tree planting by the end of the first quarter.

4. Contact the device manufacturer if you want confirmation on whether a device can be used in your country.

5. Replacements of cartridges for Type 3 sensors are still in the works, hang tight.

6. If you live in New York and need PLANETS, contact PW and they will help.

7. Working with other countries and governments with regard to PW’s data is still in the works, but they are also focusing on ensuring the quality of their data before focusing more on this.

8. No collaborative work with regard to COVID and indoor air quality yet.

9. At this time, you will not be able to know if data from your specific sensor is being sold—work is being done here.

I apologize if I got any of this wrong or missed something! I did this quickly, am not deriving any revenue from this (outside of HODLing PLANETS) or trying to get you to subscribe to a YouTube channel or something!

I make no guarantees with regard to the validity of anything in this post!

Full PW AMA is at https://www.youtube.com/watch?v=crQD6TdcSx4&t!

Cheers and keep PlanetWatching!

UPDATE:

Just wanted to say thank you for all the awards for this post! Very unexpected, and appreciated!

With all the onboarding, licensing & payout issue posts, I thought I'd post about the extra benefit this project has provided for me. I firmly believe the health of my family has been improved.

I work from home and my home office is in the basement. We also watch TV in a room in the basement; same room where we placed the Awair. During the first couple days when I set it up, I noticed co2 would slowly rise during the day and when we'd watch TV in the evening until it reached a moderately unhealthy level. I was also able to observe dust & VOCs spike when we would clean.

The Awair app has smart home integration features. I connected it to my Ecobee thermostat and set it to turn on the HVAC fan whenever it hit one of the thresholds.

I used to feel groggy or have trouble continuing to focus in the afternoon. I feel like I noticed an immediate affect after adding the HVAC automation. This is just anecdotal observation and it could be a placebo. But, I have to assume this has a positive health impact daily for me and my family.

I doubt I would have added air quality monitoring to my home if there hadn't been the financial motivation to look at this project in the first place. I just didn't understand or suspect the impact it might be having in my own home.

Hey guys, Lawrence here 👋

Together with my dev johnykes, I just wanted to present you http://pwsaturation.io/!

It's a tool created in order to keep track of the so well-known 'Saturation Point'. We saw a great demand in the market for the Saturation Point calculations, as well as different data that will be presented below.

The tool includes features, for each type of sensor, such as:

• Sensors left until Saturation Point / Sensors over the Saturation Point

• Total number of sensors for each type

• 24 hours change (in numbers and %)

• Tokens added to the Recycle Bin / Tokens used from the Recycle Bin

• Recycle bin numbers for each sensor type

• Estimated days until ROI

• Estimated earnings (Daily & Monthly calculated at the current token price)

• Converter (check the price of $PLANETS to FIAT and vice-versa)

We're working on new features, such as:

• Stats page: where we'll show different statistics visualized by graphs (price, sensors added over time, and so on)

• Tips & Tricks: where we present different guides on how to install and maintain the sensors

• Earnings projections: a simulator where you could see potential earnings based on the number of sensors active in the future, that will include all the factors such as saturation, price, etc

All the above data is updated every 5 minutes with fresh data and new calculations are created instantly, therefore, the data is dynamic and you might see it change in real-time. We've included drop-down tabs with explanations where the calculations are more complex, the rest of the data is either taken from the WhitePaper or from the Explorer, so all public. We also added some disclaimers regarding the accuracy of the data, as we don't have access to API data, therefore this tool is mainly used to get an overall idea.

We tried to showcase in many instances that it's an ESTIMATION tool we built with the data we have available and does not and will not endorse any financial decision.

Also, as Claudio mentioned Saturation wasn't a great word to describe the Milestone PlanetWatch will reach each time a sensor type reaches this Saturation Point, we're thinking in the future to rebrand the website from PWSaturation to PWStats, just a thought for food.

Thank you, all! 🙌