{"id":19909263,"url":"https://github.com/spiderlabs/cerealbox","last_synced_at":"2025-05-03T02:31:40.416Z","repository":{"id":139217339,"uuid":"2225399","full_name":"SpiderLabs/cerealbox","owner":"SpiderLabs","description":"Arduino-based network monitor","archived":false,"fork":false,"pushed_at":"2011-09-19T17:59:42.000Z","size":2314,"stargazers_count":24,"open_issues_count":0,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-07T10:35:50.060Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SpiderLabs.png","metadata":{"files":{"readme":"README.txt","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-08-18T01:21:22.000Z","updated_at":"2024-08-16T17:46:39.000Z","dependencies_parsed_at":"2023-03-13T10:49:53.005Z","dependency_job_id":null,"html_url":"https://github.com/SpiderLabs/cerealbox","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpiderLabs%2Fcerealbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpiderLabs%2Fcerealbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpiderLabs%2Fcerealbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpiderLabs%2Fcerealbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SpiderLabs","download_url":"https://codeload.github.com/SpiderLabs/cerealbox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252133729,"owners_count":21699588,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T21:14:49.529Z","updated_at":"2025-05-03T02:31:39.996Z","avatar_url":"https://github.com/SpiderLabs.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"cerealbox \nSteve Ocepek \u003csocepek@trustwave.com\u003e\nhttp://www.spiderlabs.com\n\nINTRODUCTION\n============\n\ncerealbox is an Arduino-based network monitor. \n\n\nREQUIREMENTS\n============\n\nThis code should run on any Arduino board with 2k SRAM equipped with\nColors Shield, or the all-in-one Colorduino board. Both Colorduino and\nColors Shield are available from iTead Studio. Colorduino does not include\na USB port, so novices (like me) should use the Colors Shield + Arduino Uno.\n\nhttp://iteadstudio.com/\n\nTest/Dev system is: Ardunio Uno, Colors Shield, 8x8 round LED matrix (iTead)\n\nThe Colorduino library by Lincomatic is required and can be found here:\n\nhttp://blog.lincomatic.com/?p=148\n\nAlso included is cb.pl, a sniffer that provides network session data\nto the Arduino over USB. Perl requirements for cb.pl include:\n\nNet::Pcap\nNetPacket (Ethernet,IP,TCP,UDP)\nGeo::IP\nDevice::SerialPort\n\n\nUSAGE\n=====\n\nArduino\n-------\n\nLoad cerealbox.pde or meter.pde onto Arduino using the Arduino IDE.\n\ncerealbox.pde displays a dot for each open session, color-coded to the \nCountry Code of the remote host.\n\nmeter.pde shows types of sessions being established in an \"equalizer\"\ntype view.\n\nRED     - Web (80,443,8080)\nBLUE    - DNS\nGREEN   - Remote protocols (SSH,Telnet,RDP)\nYELLOW  - Mail protocols (POP3,SMTP,IMAP,LDAP)\nPURPLE  - File protocols (FTP,SMB,AFP,LPR)\nORANGE  - Other ports, under 10000\nCYAN    - Other ports, over or equal to 10000\nWHITE   - Local hosts\n\nPerl\n----\n\nThis program requires root privileges to sniff packets.\n\ncb.pl (net_device) (src_ipaddr) (serial_device) [dns]\n\nnet_device is the network device to listen on, ex. eth0\n- Running cb.pl without args will show all available interfaces\n\nsrc_ipaddr is the source IP address of the host to be monitored.\n- In normal cases, this will be the host's own IP address\n- Could be used to sniff another host's traffic in cases where\n  traffic is visible (i.e. MITM, ethernet tap, wireless)\n\nserial_device is the USB serial device that the Arduino is using, ex:\n- /dev/ttyUSB0 on Linux\n  Or whichever was assigned to Arduino, use dmesg to find out\n- /dev/tty.usbmodem262312 on Mac OS X\n  Use ls /dev/tty.usbmodem* to find this\n\nUntested on Windows, not sure whether Device::SerialPort can handle\nCOM: ports\n\ndns specifies that DNS sessions should be tracked and displayed\n- Useful for meter mode, but this traffic tends to fill up session mode\n  (cerealbox.pde) very quickly\n\n\n\nCOPYRIGHT\n=========\n\ncerealbox - Arduino-based network monitor\nCreated by Steve Ocepek\nCopyright (C) 2011 Trustwave Holdings, Inc.\n \nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n \nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspiderlabs%2Fcerealbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspiderlabs%2Fcerealbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspiderlabs%2Fcerealbox/lists"}