Top quality software products and creative apps for your iPhone, iPod touch & iPad

JKnit - Knitting Project Assistant app

Your ultimate knitting project assistant

JKnit Tutorials

Tutorial 1: Covering the Basics

by Julia Kroyan

This tutorial is based on the Slouchy Striped Hat pattern (download now) which is available as a free download on Ravelry. This pattern is not very complicated, which makes it a good example to use in this tutorial. I am going to cover some of the basic concepts and features in JKnit and show how to set up a complete project on your mobile device. You can also use the same approach to set up a project on the web portal.

This tutorial uses the following conventions:

  • Pattern directions appear in blue italics.
  • JKnit project configuration settings are shown in blocks with a light blue background.
  • This tutorial describes project input on a mobile device (setup on the web portal is very similar).
  • tutorial 1 images

    Slouchy Striped Hat pattern and images. 2010-2011 Copyright © Julia Kroyan. All Rights Reserved.

    To start, create a new project by pressing the '+' button on the bottom right of the My Projects screen and name it, for example, Slouchy Striped Hat. JKnit will then take you to the Project Pieces. Every project in JKnit must consist of one or more pieces. Generally, use your pattern directions and personal preferences to determine how many pieces your project has to have. To make the setup most straightforward, this project will have two pieces: one for the brim and another one for the rest of the hat.

    Create the first piece by pressing the '+' button on the bottom right, which will take you to the Piece Setup screen. First, input a descriptive name for the piece - in this case Brim. Below the piece name is the Current Row Number setting, which lets you change the current value of the row counter for this piece. By default, it is set to 0 when you create a new piece which typically is an appropriate starting value. Next, set the Number of sts at Start. This feature automatically keeps track of the number of sts on the needles in each row and display it just below the row counter on the Counter screen. In this piece, we do not need to use this feature, so we just leave it at 0.

    Now we are ready to start inputting the pattern directions for the brim into JKnit. Normally, every knitting pattern consists of a sequence of specific instructions and steps. In JKnit, we refer to such individual instructions and steps as events. So, in order to setup a piece, you have to schedule a list of events. You can also insert a preconfigured block of instructions into a piece, but this feature will be covered in Tutorial 3. So let's get started!


    Cast on 120 sts in color A and divide them evenly onto 4 DPNs (30 sts per needle). Join for working in the round. Place a stitch marker at the end of the round. You may want to switch to a circular needle if, at any point, you feel like there are too many sts on the DPNs.

    For the brim, work in 1-by-1 ribs (K1, P1) for 2 inches (5 cm).

    We are going to setup three events to express these directions: one for cast on, one for ribbing, and another as a reminder to stop at 2 inches. First, let's set up the cast on event to start at row 0. Tap on Add New Event to advance to the Event Setup screen, and configure the event starting position and the note as follows:

    Event Type: Alert

    Start: Row 0

    Note: Cast on 120 sts in color A onto 4 DPNs, 30 sts per needle

    Next, take a look at the Occurrence Settings. By default, a newly created event is set to occur just once. But, if needed, you can easily make it repeat by tapping on the occurrence settings cell. This will take you to the Event Occurrence screen where you can define in which rows and how many times an event should occur. Since the cast on happens only once, the default settings do not need to be changed.

    Since we are done with the first event, return to the Piece Setup screen by pressing on the Back button on the upper left. If you ever need to modify this event's settings, just navigate to the Piece Setup screen and tap on it in the list of events.

    Next, let's input the event for ribbing, which would start at row 1. Since you have to make it two inches high and, at this point, it is unknown how many rows that would be, we will make this event repeat in every row and set the How Many Times? to Unlimited.

    Event Type: Alert

    Start: Row 1

    Note: Ribbing: k1, p1

    Occurrence Settings:

    Every Which Row? 1

    How Many Times? check the 'Unlimited' box

    Finally, to finish the brim, let's add another event to remind you to stop the ribbing when it is 2 inches high. To do that, set the starting position units for this event to Ht(in) and the value to 2. This event will appear in the Upcoming Height Events list on the Counter screen.

    Event Type: Alert

    Start: Ht(in) 2

    Note: End of ribbing, start the next piece

    We are done configuring the brim piece, so we can go back all the way to the Project Pieces screen and add the second piece. You can always access the settings for an existing piece by going to the Counter screen and pressing the Setup button in the upper right.


    Let's move on with the setup of the next piece. We'll name it Hat since it represents the main part of the hat. You can leave the Current Row Number at 0 or preset it to 1 since that will be the starting position of the first event in this piece. Next, set the Number of sts at Start to 120. Now, let's take a look at the first instruction:

    After finishing the brim, for the main part of the hat, knit all sts.

    To describe this instruction, set up an event that will prompt you to knit all stitches in every row:

    Event Type: Alert

    Start: Row 1

    Note: K all sts

    Occurrence Settings:

    Every Which Row? 1

    How Many Times? check the 'Unlimited' box


    In the first row after the brim, evenly increase by 36 sts, which makes 156 sts on the needles.

    This is an instruction to increase stitches. Set the event type to Increase and the starting position to row 1. Increasing or decreasing evenly can be a bit of a hassle. But we have a great app, called Knit Evenly that makes this task very simple (sorry about the plug, but this a perfect place to mention it...). After plugging in the numbers, I just copied the resulting directions to the event note. Lastly, note that, since this is an increase event, the occurrence section also includes the increase parameters.

    Event Type: Increase

    Start: Row 1

    Note: [k4, M1, (k3, M1) 2x] 12x

    Occurrence & Inc. Settings:

    Every Which Row? 1

    How Many Times? 1

    # of Stitches: 36

    Side: evenly (E)


    Knit the main part of the hat in the following colors:
    (6 rounds of color A, switch to color B for 8 rounds), 3 times. Then, switch back to color A for the rest of the hat.

    We cannot input this instruction as a single event because the color stripes are not of the same thickness. But we can easily divide it into two events: one for switching to color A and the other for switching to color B.

    First, make the event which indicates to switch to color B. This happens the first time at row 7 and, therefore, the event is set as follows:

    Event Type: Alert

    Start: Row 7

    Note: Switch to color B

    Since we have 8 rows of color B and 6 rows of color A, both of these stripes together add up to 14 rows. Therefore, we will make the event occur every 14 rows, 3 times in total (since we have 3 stripes in color B):

    Occurrence Settings:

    Every Which Row? 14

    How Many Times? 3

    Next, let's add another event for the step of switching to color A:

    Event Type: Alert

    Start: Row 15

    Note: Switch to color A

    Occurrence Settings:

    Every Which Row? 14

    How Many Times? 3

    This example illustrates that you can split a more complex instruction into several simple events by figuring out how steps repeat in a pattern. This is even more true for cable patterns for which it really pays off to create separate events for different kinds of cables. You can refer to the cable tutorial for more information on this topic.


    At 4.25 in (11 cm) measured from the cast-on edge, place 6 stitch markers in the following manner: (K26, pm) 6 times.

    Event Type: Decrease

    Start: Ht(in) 4.3 (JKnit allows only one decimal), or Ht(cm) 11

    Note: (K26, pm) 6 times

    Since this event starts at a specific measurement height and not at a known row, we refer to it as a height event. When you are knitting and the piece measures 4.25 inches, you will have to manually add this event to the row counter. To do this, pull up the Upcoming Height Events list by pressing the Arrow button on the lower right of the Counter screen. Then, press the Start button of the event that you would like to add to the row counter. Note that you can undo this action by frogging a row, and the height event you just added will move back to the top of the list of upcoming height events.


    In the next round, evenly decrease by 6 sts:
    decrease round: (knit to 2 sts before marker, k2tog) 6 times. 150 sts.
    Repeat the decrease round 13 more times every 2nd round, then 11 more times in every round. 6 sts.

    The decrease round starts immediately after the previous event, but we do not know the starting row number in advance. So we have link the start of this event to the completion of the previous event. To do that, set the Linked? switch ON, and configure the settings as shown below:

    Event Type: Decrease

    Start: Linked? ON, In Which Row? 1, After Which Event? "(K26, pm) 6 times"

    Note: (knit to 2 sts before marker, k2tog) 6 times

    The first set of decreases occurs every 2nd round for a total of 14 times:

    Occurrence & Dec. Settings:

    Every Which Row? 2

    How Many Times? 14

    # of Stitches: 6

    Side: evenly or middle

    The rest of the decreases are done in every round. They follow the previous set of decreases and are different only in their occurrence settings. So instead of inputting them as a separate event, we can add them as a follow-up stage within the same event. This stage will immediately follow the first stage. Generally, being able to use stages is a very useful feature for steps that are comprised of several instructions that differ only in their occurrence parameters. In the Event Setup screen, scroll to the bottom and turn the Follow-Up Stages? switch to ON. Now you can add the following stage:

    Occurrence & Dec. Settings:

    Every Which Row? 1

    How Many Times? 11

    # of Stitches: 6

    Side: evenly or middle


    Cut the yarn with a tail long enough to thread through the remaining sts and tighten. Weave in all ends.

    Lastly, we can make one more linked event for the finishing of the hat:

    Event Type: Alert

    Start: Linked? ON, In Which Row? 1, After Which Event? "(knit to 2 sts before marker, k2tog) 6 times"

    Note: Cut the yarn with a tail long enough to thread through the remaining sts and tighten. Weave in all ends.

    Again, this event occurs just once and the default occurrence settings are fine.


    We are done with the setup, and now you can start knitting! Go back to the Project Pieces screen and select the first piece. As you advance the row counter, all events for the current row will appear in the list of current row events. Tapping an event in that list will display its detailed view. There, you can read the entire note, view event completion statistics and more.