My Journey Through Open Source

My Journey Through Open Source

Tags
OSS
Published
Aug 6, 2018
Why I find working on open source so rewarding and a breakdown of some of my favorite projects.

Intro

The feeling of working on open source is strangely unique and fulfilling. You feel as though you’re contributing to a greater good comprised of a network of brilliant people from all around the world. It’s a sensation that I rarely feel in my general work as a software engineer, and it reminds me of why I got into programming in the first place.
Towards that end, I’d love to share some of the open source projects that I’ve worked on, with the hope that they will inspire someone out there to do the same!
Whether it’s finding a cool project that you’re interested in, forking it, and contributing back (guide), or if you want to get better at publishing your own open source projects, I encourage you to get out there and start committing!

Categories

Node.js

notion image
  • update-markdown-jsdoc — Updates a markdown document section with jsdoc documentation. Useful to automatically update a library’s readme with API docs.
  • update-markdown-usage — Updates a markdown document section with CLI usage info via --help. Useful to automatically update a CLI’s readme with Usage docs.
  • p-cache — Decorator to memoize the results of async functions via lru-cache.
  • random — Seedable random number generator supporting many common distributions.
  • id-shortener — Efficient id / url shortener for Node.js backed by pluggable storage defaulting to redis.
  • node-compat-require — Easily allow your Node program to run in a target node version range to maximize compatibility.
  • async-await-parallel — Node.js module with simple concurrency control for awaiting an array of async results.
  • snapchat — Node.js client for the unofficial Snapchat API
  • ip-set — Efficient mutable set data structure optimized for use with IPv4 and IPv6 addresses. The primary use case is for working with potentially large IP blacklists.
  • rect-cover — Computes a transform between two rects just like background-size: cover. (demo)
  • rect-contain — Computes a transform between two rects just like background-size: contain. (demo)
  • webtorrent — Streaming torrent client for the web. ⚡️ (demo) (contributor)
  • ow — Function argument validation for humans. (contributor)

React

notion image
Create React Library (CRL) is easily one of my favorite and most used open source projects. It’s kind of like Create React App (CRA)’s younger sibling. It even uses CRA under the hood for example usage and local component development.
Example of using create-react-library to create a reusable React component npm package.
Example of using create-react-library to create a reusable React component npm package.

Puppeteer

notion image
Example output png produced by puppeteer-render-text.
Example output png produced by puppeteer-render-text.

FFmpeg

notion image
  • ffmpeg-concat — Concats a list of videos together using ffmpeg with sexy OpenGL transitions.
ffmpeg-concat OpenGL transitions demo (also applies to ffmpeg-gl-transition)
ffmpeg-concat OpenGL transitions demo (also applies to ffmpeg-gl-transition)
  • ffmpeg-probe — Wrapper around ffprobe for getting info about media files.
  • p-exiftool — Wrapper around exiftool for reading metadata from many different file types.
Example extracted frames from a GIF via gif-extract-frames.
Example extracted frames from a GIF via gif-extract-frames.

Crawling

captcha-solver handles many different types of captchas, including Google’s reCAPTCHA v2.
captcha-solver handles many different types of captchas, including Google’s reCAPTCHA v2.
  • captcha-solver — Library and CLI for automating captcha verification across multiple providers.
  • parse-email — Parses mime-encoded email messages.
  • parse-otp-message — Parses OTP messages for a verification code and service provider.

Graphics

Before & After demo of the primitive algorithm reconstructing an image with 500 random shapes.
Before & After demo of the primitive algorithm reconstructing an image with 500 random shapes.
  • primitive — Reproduce images from geometric primitives. (demo)
  • primitive-cli — CLI to reproduce images from geometric primitives.
  • phash-gif — Perceptual GIF hashing for easily finding near-duplicate GIFs.
Demo of dissolve effect generator.
Demo of dissolve effect generator.

Koa

notion image

Misc

  • Milton — C++ Rendering Framework w/ MLT, bidi path tracing, etc. and OpenGL Previews (undergrad thesis project from Brown ‘09).
(Milton) The same scene rendered using ray tracing (top left), path tracing (top right), bidirectional path tracing (bottom left), and MLT (bottom right). The brute force path traced version in the top right should be seen as a correct, reference image. Note the lack of caustics on the floor and lack of indirect illumination in the ray traced version. Discrepancies in the bidirectional path tracing and MLT renders are due to differences in tone mapping as well as implementation issues with correctly handling specular paths.
(Milton) The same scene rendered using ray tracing (top left), path tracing (top right), bidirectional path tracing (bottom left), and MLT (bottom right). The brute force path traced version in the top right should be seen as a correct, reference image. Note the lack of caustics on the floor and lack of indirect illumination in the ray traced version. Discrepancies in the bidirectional path tracing and MLT renders are due to differences in tone mapping as well as implementation issues with correctly handling specular paths.
  • Mipscope — Cross-platform IDE for students learning assembly on the MIPS architecture. The focus is on a convenient debugging environment, including a visual, reversible debugger.
  • Gravity-spritekit — iOS n-body simulation visualized with metaballs. Physics and graphics provided by SpriteKit.
  • Gravity-cocos2d — iOS n-body simulation combined visualized with metaballs. Physics and graphics provided by cocos2d.
Gravity visualization demo (Gravity-spritekit, Gravity-cocos2d).
Gravity visualization demo (Gravity-spritekitGravity-cocos2d).

Conclusion

I’ve had a lot of fun creating all of these open source modules & demos. The open source community is thriving, especially for JavaScript & NPM.
Hopefully, one or more of these projects will spark your curiosity to fork & experiment… or you’ll go on to create your own open source projects that are better than mine! 😜
And finally, follow me on GitHub if you want more awesome open source goodness!