Skip to content

Commit 39900e1

Browse files
committed
documentation cleanup
Signed-off-by: kkarhan <[email protected]>
1 parent ca59527 commit 39900e1

File tree

1 file changed

+35
-16
lines changed

1 file changed

+35
-16
lines changed

README.md

+35-16
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,27 @@
11
# lists.d
2+
23
### listings for known devices, device identifiers, public servers and more.
34

45
---
56

6-
#### These identifiers are device data are provided as-is with no guarantee of accuracy or reliability, and are meant for ITsec-related education & training purposes only!
7-
8-
Lists are provided as [TSV files](https://en.wikipedia.org/wiki/Tab-separated_values) with [POSIX-compliant line endings](https://en.wikipedia.org/wiki/Newline#Representation) in order to make them easily searchable and interpretable for applications whilst retaining human readability and editability with text editors, scripts and spreadsheet programs.
9-
10-
## INPORTANT NOTICE:
11-
### All info has been taken from publicly available sources, not from private data or leaks.
12-
#### We will reject all pull requests with data that have been obtained from non-public data and without proper source deeplinking to verify that these are not attempts at d0xxing or other actions that are not only violating GibHub's ToS but also might have serious legal remifications attached to them!
13-
###### Being listed is not an explicit endoresement of said services, sites and/or their maintainers. Tho we will take reports seriously and will act accordingly in case some will act against our values and common interests.
14-
Knowledge is Free!
157

16-
---
178
## Currently Existing Lists:
9+
1810
- Devices
1911
- [IMEI](./imei.devices.list.tsv)
2012
- [MAC](./mac.devices.list.tsv)
21-
- [default logins](./default.logins.list.tsv) - for various devices and systems
13+
- [USB Device IDs](./usb.devices.list.tsv)
14+
- [known default logins](./default.logins.list.tsv)
2215
- Services
2316
- [Dialup Internet Access](./dialup.providers.list.tsv)
2417
- [IPTV Streams](./iptv.livestreams.list.tsv)
18+
- [Download Links to popular Software and Distributions](./largefiles.downloads.links.list.tsv)
2519
- Public Servers
2620
- [DNS](./dns.servers.list.tsv)
2721
- [NTP](./ntp.servers.list.tsv)
2822
- [eMail](./email.servers.list.tsv)
2923
- [XMPP / Jabber](./xmpp.servers.list.tsv)
30-
- [IRC Networks](./irc.networks.list.tsv)
24+
- [IRC Networks](./irc.networks.list.tsv)
3125
- [BitTorrent Trackers](./bittorent.trackers.list.tsv)
3226
- [Bona-fide Onion Services](./onion.domains.list.tsv)
3327
- [ActivityPub Servers](./activitypub.servers.list.tsv)
@@ -56,24 +50,46 @@ Knowledge is Free!
5650
- aka. ["shooting the messenger"](https://en.wikipedia.org/wiki/Shooting_the_messenger)
5751
- [public logins](./logins.list.tsv)
5852

53+
5954
---
6055

56+
## Important Notice:
57+
58+
#### All information here is provided as-is with no guarantee of accuracy or reliability, and is meant for bona-fide purposes only!
59+
60+
Lists are provided as [TSV files](https://en.wikipedia.org/wiki/Tab-separated_values) with [POSIX-compliant line endings](https://en.wikipedia.org/wiki/Newline#Representation) in order to make them easily searchable and interpretable for applications whilst retaining human readability and editability with text editors, scripts and spreadsheet programs, maximizing accessibility and compatibility at the same time.
61+
62+
## Privacy Notice:
63+
64+
### All info has been taken from publicly available sources, not from private data or leaks.
65+
66+
#### We will reject all pull requests with data that have been obtained from non-public data and without proper source deeplinking to verify that these are not attempts at d0xxing or other actions that are not only violating GibHub's ToS but also might have serious legal remifications attached to them!
67+
68+
###### Being listed is not an explicit endoresement of said services, sites and/or their maintainers. Tho we will take reports seriously and will act accordingly in case some will act against our values and common interests.
69+
70+
Knowledge is Free!
71+
6172
## FAQ
6273

6374
### Where can I get the latest version?
75+
6476
If you need the latest main branch, you can just [download it here directly from GitHub](https://github.com/greyhat-academy/lists.d/archive/refs/heads/main.zip).
77+
6578
- You can also find [the latest "release" here](https://github.com/greyhat-academy/lists.d/releases/latest).
66-
Either way, simply unpack and you should get the TSV files which you can then edit with your favorite editor, spreadsheet tool or IDE and parse in your scripts.
79+
Either way, simply unpack and you should get the TSV files which you can then edit with your favorite editor, spreadsheet tool or IDE and parse in your scripts.
6780

6881
### Why make this repo?
82+
6983
There are various reasons why I started this:
84+
7085
- I needed a convenient way to version, update and manage essential configurations like DNS- & NTP-Servers as well as being able to just simply fetch and apply them when setting up systems, or at the very least just pull the latest version in a script.
7186
- I don't want to constantly copy & paste any current recommendation but have a fixed link to said repo for use on projects and recommendation.
7287
- Others might benefit from sharing said data and being able to contribute too.
7388
- Please feel free to [open up an issue](https://github.com/greyhat-academy/lists.d/issues) if you have any suggestions, like adding your own data to it
7489
- Don't forget to provide source links!
7590

7691
### Why use it?
92+
7793
- It just works!
7894
- Due to using TSV files you can simply pull said lists and query them with any tool that can handle plaintext.
7995
- [from pfBlockerNG](https://twitter.com/k3vk4/status/1564055009762967555) and a lot of CLI / TUI tools and scrips to even GUI-based spreadsheet programs like LibreOffice Calc...
@@ -86,18 +102,21 @@ There are various reasons why I started this:
86102
- But it's part of the toolkit of many people - both contributors and non-contributors.
87103

88104
### Why contribute to it?
105+
89106
- We're open and welcoming towards contributions.
90107
- OFC, behave yourself! We'll not tolerate spamming, harrasment and cybervandalism in our repo and will take foreseeable consequences within the appropriate channels to act against such misbehaviour!
91108

92109
### I'm having issues with a certain list, help!
110+
93111
- If you're certain your issue is caused by said list, please [open up an issue here](https://github.com/greyhat-academy/lists.d/issues) and provide as much detail as possible.
94112
- We're quick to react and remediate issues if caused by us
95113
- see [this example](https://github.com/greyhat-academy/lists.d/issues/17)
96114

97115
### Which License do you use?
116+
98117
- The entire repo is [licensed under CC-BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
99118
- You can find the [license here.](./LICENSE.md)
100119
- This means you can use it everywhere, but you cannot sell with or as part of a commercial product [i.e. network security appliance].
101-
- Customers / end-users may be made aware and provided step-by-step or automated tools to use and query it, but they should be made aware that this is a freely accessible list and not part of your commercial product and/or services.
102-
- You'll have to comply with the terms of the license.
103-
- Please feel free to inform us if you use our lists and/or contribute to them.
120+
- Customers / end-users may be made aware and provided step-by-step or automated tools to use and query it, but they should be made aware that this is a freely accessible list and not part of your commercial product and/or services.
121+
- You'll have to comply with the terms of the license.
122+
- Please feel free to inform us if you use our lists and/or contribute to them.

0 commit comments

Comments
 (0)