sungo 8 months ago
commit
023ba1760c
3 changed files with 91 additions and 0 deletions
  1. 2 0
      .gitignore
  2. 27 0
      LICENSE.txt
  3. 62 0
      README.md

+ 2 - 0
.gitignore

@@ -0,0 +1,2 @@
+sbshttp
+

+ 27 - 0
LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright Matt Cashner (sungo)
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

+ 62 - 0
README.md

@@ -0,0 +1,62 @@
+# What?
+
+sbshttp provides an HTTP server that presents dump1090 data in the
+"standard" JSON format. 
+
+# Why?
+
+The most supported fork of dump1090, the FlightAware version, removed
+the in-memory http server. dump1090-fa can output the standard real-time
+CSV feeds or static JSON files every second to disk. Most UIs use the
+JSON files so setting up a dump1090 environment involves burning IOPs
+for no real reason.
+
+My use case is docker. I wanted an in-memory only solution that I could
+spin up without volumes or tmpsfs or other disk drama. There are old
+forks of dump1090 that retain the http server but do not pull in the
+fixes and improvements that the FlightAware folks are adding.
+
+So here's this thing. It listens to dump1090's CSV feed and provides
+their JSON format. The JSON is always up to date with the most current
+data, with no 1 second lag. Throw up a UI, point it at this like you
+would dump1090-fa, and you should be ready to go.
+
+# Support / Contributing
+
+This is a personal side project and will get about that much attention,
+maybe less. If you have patches, feel free to contact me (see
+https://sungo.wtf) but I make no promise as to when or if I'll respond.
+But, feel free to fork the code, respecting the license, and have your
+way with it.
+
+# License
+
+Copyright Matt Cashner (sungo)
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+