3.0.6

Updated the project badges. Added information about how you can support my projects (Bitcoin address, Amazon wishlist). 📖

3.0.5

• Fix the Patreon link in the README.md file. 📝

3.0.4

• Updated the README.md following the new template. 📝
• Add the Patreon link in the README.md file. If you like what I'm doing, supporting me would be awesome! Even one dollar / month would be helpful! Thanks! ❤️

3.0.3

• Updated the README.md following the new template. 📝
• Use babel-it to babelify the code, so the module is now compatible with older versions of Node.js.

3.0.2

Whitelist the npm files.

3.0.0—Modularize all the things, GraphicsMagick is optional, (better) Windows support

I have been working on this new major release since September, last year. It was a huge work to break, split and modularize the previous code. 😅

GraphicsMagick is still recommended to be installed on the system, but in case if it's not installed, the library will compile lwip—a nice Node.js image processor. ✨

After upgrading to [email protected] we got a better Windows support—in fact, this library is now compatible with the 16 colors from the Windows command prompt. Pretty cool, eh? 😁

I refactored the code base from scratch. I used ES2015 features which means you should run this using Node.js >= 4.0.0.

Another nice feature is that you can use an existing image buffer as input. Using an url or local path works too. 💫 Fixes #24.

Few other features are the new options that I added: custom/transparent background (defaults to white), custom stringify function etc. They are documented in the README.md file. 📝

By turning off the concat and stringify options we will get an object back (not a string). This allows us to modify the image before stringifying it. Fixes #17.

---

Linux Version

Windows Version

I split the monolithic structure that was here before in small reusable modules that are dependencies of this library. If someone is interested to see how the dependencies graph looks like, there you go:

• image-to-ascii—A Node.JS module that converts images to ASCII art.
  • asciify-pixel-matrix—Asciifies a matrix of pixels.
    • asciify-pixel—Asciifies a pixel object.
      • couleurs—Add some color and styles to your Node.JS strings.
        • ansy—Cross platform ANSI colors made easy.
          • custom-return—Generate a function that returns a constant.
            • noop6—No operation as a module using an arrow function.
      • ...
  • pixel-bg—Change the pixel background color.
  • pixel-class—A tiny class for pixel manipulation.
  • pixel-white-bg—Set white background color for a pixel.
  • compute-size—Helper tool for resizing the things.
    • fixed-or-percent—Get the percent or fixed value.
      • is-percent—Check if a given value is in the percent format.
        • last-char—Get the last character in a provided string.
      • percent-value—Percentage helper functions.
    • map-o—Array-map like function for objects.
      • iterate-object—A convenient way to iterate objects.
  • image-parser—An image parser that works.
    • err—A tiny library to create custom errors in JavaScript.
      • typpy—A better typeof for JavaScript.
    • gm-tools—Friendly tools for interacting with GraphicsMagick.
      • ...
    • lwipify—Convert images in lwip objects.
      • lwip2—A friendlier wrapper around the lwip library.
        • gm-installed—Check if GraphicsMagick is installed.
          • prgm-installed—Check if a program is available on the system.
            • ...
      • url-remote—Checks if a given url is a remote url or not.
        • url-local—Checks if a given url is a local url or not.
          • parse-url—An advanced url parser supporting git urls too.
            • is-ssh—Check if an input value is a ssh url or not.
              • protocols—Get the protocols of an input url.
    • pixel-class—A tiny class for pixel manipulation.
      • deffy—Small and fast library to set default values.
        • typpy—A better typeof for JavaScript.
  • imgpx
    • lwip-pixels
      • pixel-class—A tiny class for pixel manipulation.
        • deffy—Small and fast library to set default values.
          • typpy—A better typeof for JavaScript.
    • lwipify—Convert images in lwip objects.
      • ...
  • one-by-one
    • deffy—Small and fast library to set default values.
      • typpy—A better typeof for JavaScript.
      • ...
  • terminal-char-width
    • ...
  • ul—A minimalist utility library.
    • deffy—Small and fast library to set default values.
    • typpy—A better typeof for JavaScript.

2.3.1

• Added badges 🎉
  • PayPal Donations
  • npm downloads
  • npm version
  • Travis (if there are tests)
  • CodeMentor–you can ping me there if you need help with one of these modules (or help in general).
• Updated the LICENSE year. 🎆

2.3.0

• Fixed the test directory references.
• Adds a new option imageMagick (Boolean) which configures gm to use ImageMagick instead of GraphicsMagic. Thanks @Starefossen! 🍰

2.2.0

• Added package.json
• Improved the documentation.
• Integrated json2md with blah to get the best flexibility in generating documentation. 💫
• Relicense to MIT and link to the license. ❤️

Regarding the integration of json2md into blah, read this blog post I wrote.

2.1.0

This update is part of the biggest process of cleaning up my GitHub projects:

• Some of the repos were merged with other repos. 🎈
• Obsolete repositories (actually these that didn't have any functionality) were been deleted. 🔥
• Most of them got better documentation using blah configuration. 📖 📚 📝

Changes

• Improved documentation 📝
• Added/updated the the CONTRIBUTING.md file. 📖
• Integrated json2md with blah to get the best flexibility in generating documentation. 💫

Regarding the integration of json2md into blah, read this blog post I wrote.