Skip to content

Latest commit

 

History

History
325 lines (230 loc) · 18.4 KB

sfpc-fall-2019.md

File metadata and controls

325 lines (230 loc) · 18.4 KB
Raw

P2P Folder Poetry – SFPC Fall 2019

Table of Contents

Terms

  • Folder Poetry is the practice of using the structure of computer folder organization as a new kind of poetic form like the haiku or iambic pentameter. By naming and nesting folders and files, we can create unfolding narratives, rhythmic prose, and choose-your-own-adventure poetry.
  • The Terminal is desktop application to control and make changes to your operating system by typing text commands. In this class we'll use the terminal to create folder poetry.
  • Bash is the programming language we'll use in the terminal, often one line at a time, but we can also put Bash code in a file and run that file.
  • Peer-to-peer computing is a way to make distributed networks in which each computer can act as a server for the others, allowing shared access to files without the need for a central server.
  • Dat is a data distribution tool for publishing on peer-to-peer networks.

Preparation before Class

Install, Respond to the Prompt, & Read Folder Poetry

1. Install Node & Dat

Run each of these Bash lines one after the other by pasting them in your Terminal application and pressing ENTR. Don't worry if you've never used terminal before or you're not comfortable with it! There will be time in class to install if you dont get to it before class.

  • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.0/install.sh | bash
  • source ~/.bash_profile
  • nvm install --lts
  • nvm use --lts
  • npm install -g dat

2. 🌳Prompt: Folder Poem as Home

What would your utopic, liberatory living environment look like?

Gently explore your imagination and think about the following prompt. Come to class with writing, diagrams, or sketches in response to these guiding questions.

  • Imagine a kind of housing or space that could hold all your friends, chosen family, and maybe your biological family too.
  • This home does not have to be realistic or even physically probable.
    • What kinds of rooms, interconnecting hallways, or gardens could be grown? What kinds of activities would residents do in different spaces throughout the home?
    • Consider the kinds of relationships you would like this home to hold & how people could relate to each other differently based on the proximity of their daily lives?
    • Consider how you would like to share space with others in this home. How are different parts of your home accessed and by whom?
    • Consider the ephemeral aspects of your home as much as the physical aspects.
    • In this home, how do you communicate and care for each other?
    • What are the emotional qualities of the spaces in your home?
    • What is the weather like around your home?
    • Consider the many forms it could take,
      • A palace with many rooms. In each room a memory of something that happened in this room with someone in you live with.
      • A forest of folders where each resident is tree and insect files carry messages back and forth between them.
      • A school where each room is devoted to something you would like to learn collectively with those you share a home with.
      • A multi-generational interconnected courtyard housing compound with rooms for climbing, rooms for growing, rooms for cooking, rooms for learning.

3. Read Folder Poetry

Folder Poetry Examples


Agenda

  • Download Garden
  • Our Folder Names
  • Preparation / Installation / Downloading
  • Introduction: Melanie's files

Part I: Folder Poetry

Reintroduction to computers & computing Programming is about the computer, the programmer, the relationship they have with each other, and the environments they create together.

  • Folders & file systems
  • What is Folder Poetry and how will we be creating it?
  • Discretely categorizing things. The affordances of folders.
  • Examples of folder projects
  • Folders Anonymous

Part II: Terminal & Bash

The Desktop is a lie

  • Terminal and Bash commands
  • Introduction of navigating the command line by walking through the-garden-of-forking-paths
  • Anatomy of Bash Prompt
  • Editing bash_profile

Part III

Making our Folder Poem Homes

  • Folder Home Structure
  • Bash commands
  • Folder Poetry Rules

Part IIII: Peer-to-Peer Poetry with Dat

The network is a folder poem, be the poet

  • P2P introduction and description of DAT and "the cloud"
  • Dat is a protocol for sharing data between computers.
  • Dat’s strengths are that data is hosted and distributed by many computers on the network, that it can work offline or with poor connectivity
  • The Distributed Web is about decentralization of servers and control
  • Data on the distributed web is not indexed which means it is not easily searchable
  • We are creating a local network island away from the default(larger) internet
  • Sharing our Poems on the P2P Web

P2P Folder Poetry Rules

The artform of folder poetry is forgiving, Dat is not

P2P folder poetry has specific requirements in order for your poems to be shared with each other via the Dat protocol. If you don't follow these rules, you will have still created folder poetry, they just wont become P2P folder poetry during this workshop.

🔴 No empty folders.
🔴 Every file has to contain text in it.
🔴 Underscores and dashes are ok. for example: my_file.txt or my-file.txt
🔴 All files must have a file extension such as .txt

🎲 Bash & Terminal commands

Command Description
cd change directory
cd .. change directory one level back
ls list contents of directory
pwd print working directory
mkdir foldername create a folder named foldername .
touch dandelion.txt create a file named dandelion.txt
echo "woof woof" > kitty.txt creates a text file called kitty.txt that contains the words, "woof woof"
cat filename.txt print contents of file
rm -rf filename.txt . remove a file or folder this way
mv filename.txt newfilename.txt rename a file
open . (macOS) open the current folder in Finder
explorer.exe . (Windows) open the current folder in Explorer
open filename.txt (macOS) opens file in Text Edit
notepad.exe filename.txt (Windows) opens file in Notepad
cp filename.txt filename2.txt copy file
say "hello, what is poetic computation?" (macOS) speak out loud
man cd show the manual for 'cd'. Press q to quit
source ~/.bash_profile restart your terminal config file

Keyboard Terminal Shortcuts

Command Description
Up + Down Arrow keys scroll through history
Tab Key autocomplete
CMD + CTRL + SPACE Emoji Keyboard (Mac OS)

Editing a text file

command Description
echo "woof woof" > kitty.txt creates a text file called kitty.txt that contains the words, "woof woof"
nano textfile.txt open file in the nano text editor
CTRL + X , y , ENTER exit and save changes

Editing your ~./bash_profile

The ~./bash_profile is a configuration file for the terminal.

  1. nano ~/.bash_profile

    • This command will open your ~./bash_profile in the nano editor

In steps 2 and 3 we will paste 2 aliass AKA shortcuts that will help us visualize our folder poem structures.

  1. alias tree="find . -not -path '*/\.*' -print | sed -e 's;[^/]*/;|;g;s;|; |;g'"

    • (if you have homebrew installed enter brew install tree in another terminal window instead)

  2. alias treefile="find . -not -path '*/\.*' | xargs -I {} bash -c 'f={}; echo \$f | sed -e \"s;[^/]*/;|;g;s;|; |;g\"; if [[ \$f == *.txt ]]; then echo; cat \$f; echo; echo; fi'"

  3. export PS1="🍋 \w\n\u$ "

    • This will customize your Bash prompt. Feel free to change the emoji. (skip if you use zshell)
    • Explanation: \w shows your full file path so you'll always know where you are in the terminal, \n creates a new line in your bash prompt. \u shows your computer username, and $ symoolizes the end of a bash prompt.

  4. source ~/.bash_profile

    • reboot your terminal

Making our Folder Poems

  • cd
  • mkdir folder-friends
  • mkdir folder-poetry
  • cd folder-poetry
  • mkdir yourname-home
  • cd yourname-home
    • ^ where we'll make our poems

🕸 Sharing our Poems on the P2P Web

This part might feel tricky. Don't worry if you miss a step and encounter any problems. It’s ok, they will be easily resolved. TAs and i are here to help you :)

  • Open a totally new window in Terminal
  • cd folder-poetry this brings you into your folder-poetry folder
  • dat share this starts serving your folder on the P2P web
  • copy your hash into this spreadsheet next to your name
  • minimize this window so you dont touch it. Your folder will only be sharing as long as this terminal window is active and dat share-ing.

Networked Poems (cloning your neighbor's poem)

  • In a new Terminal window:
  • cd folder-friends
  • dat clone someone-elses-poem-hash-from-spreadsheet
  • ls you should be able to see and explore their poem!

Homework for Oct 24th

Draw and code a folder poem over the next week It can be a continuation of the Folder Poem as Home Prompt or something else you desire

Important:

  • Draw / sketch a folder poem first on paper
  • Write & code your poem using Bash in the terminal (avoid the finder)
    • Come to class with your Folder Poems on your computer, we will be sharing them over a distributed network using Dat

I will be creating a folder poetry zine from this class to share and distribute at the showcase with your folder poems alongside your folder poem drawings

Suggested:

Workshop Description

What if we could transform our online networks from something we passively receive to something we actively create? Folder Poetry is the practice of using the structure of computer folder organization as a new kind of poetic form like the haiku or iambic pentameter. By naming and nesting folders and files, we can create unfolding narratives, rhythmic prose, and choose-your-own-adventure poetry. In this workshop we will collectively create peer-to-peer folder poetry using the command line and Dat. Through lecture, examples, and writing folder poetry as meditation, we will explore the narrative qualities of folder structures and Dat as a tool for building digital spaces with and for our networks.

In this session we will get intimate with computers and write poetry with their logic. This workshop is an introduction to writing folder poetry, the P2P protocol Dat, and navigating the command line interface using Bash.

Together, we will create living networked poetry through connecting folders on the peer-to-peer web for each other to inhabit and explore.

This workshop assumes no coding experience and simultaneously takes the position that everyone who interacts with computers in some way is already a programmer.

Always Already Programmimg

Every time you make a folder or rename a file on your computer, the actions you take through moving your mouse and clicking on buttons, have an equivalent text command. When you use a visual interface (called a GUI) text commands are still being fired in the background which eventually compile to binary. Using bash in the terminal is a way to get a little closer to the metal and a little further along in uncovering the mechanics of our most common devices.

Everyone who interacts with computers has, in very real ways already been programming. The distinction between programmer and user is maintained by a tech industry that benefits from a population rendered computationally passive.

Together we can build up and cultivate one another’s agency to shape technology and online spaces that support and care for each other and our communities.

To create our folder poetry, we will use Bash in the terminal. To share our folder poetry, we will use Dat.

"Dat is a p2p protocol that enables people to publish content and information to the web from their personal computers. This fundamentally changes the relationship people have to the internet by breaking the client server hierarchy and opens the realm of self publishing to everyone." - New Computers Working Group

Notes on why we're using a spatial and narrative metaphors for learning bash and creating folder poetry

Using the command line and computing in general is a relational practice. You are never using the command line from a “global” perspective. When you issue commands from the command line, you are doing so, from a particular position within the hierarchy of your computer’s file system.

Similarly, when we are inside a house, we are never simultaneously in the kitchen and the bedroom. If we tried to “get into bed” while in the kitchen, we would not be able to. However if we wanted to wash dishes while standing in the kitchen, we would be able to.

From the command line, if we have navigated to the Desktop folder but try to perform an action on a file that’s inside your home directory, this would not work. You would have to navigate to the home folder by navigating your file path.

⛅️⛅️⛅️⛅️⛅️⛅️⛅️⛅️⛅️⛅️

Accessing Your Personal Shared Cloud (Raspberry pi)

  • ssh pi@garden
  • pw: morepoetry

your poems are in ~/folder-poetry

Emoji for loop

for i in {1..2000}; do printf ' ♡ 📂 → ➩ ➪ ➫ ➬ ➭ ➮ '; done; will create an emoji for loop

🔮 folder-spell

folder-spell is a folder poetry generator that came out of a conversation our TA Brian Solon and i had on the bus yesterday. It makes writing sentences with folders go very quickly.

  • It creates a series of nested folders with a text file at the end.
  • The first words you write after folder-spell will become a series of nested folders. The text within quotations will become the contents of a text file.

Installation

  • enter the entire following line in your terminal
    • curl https://gist.githubusercontent.com/solon/27106a5389c61dcb83fb25fa9c20787d/raw/folder-spell.sh > ~/folder-spell.sh && chmod u+x ~/folder-spell.sh && echo $'folder-spell() {\n ~/folder-spell.sh \"$@\" \n}' >> ~/.bash_profile
  • source ~/.bash_profile

Usage

  • folder-spell these are words "this is some text"

  • Another example usage:

    • folder-spell this is a folder poem generator "the first words you write will become a series of nested folders. The text within quotations will become the contents of a text file"

       ,,,                      ,,,
      {{{}}    ,,,             {{{}}    ,,,
   ,,, ~Y~    {{{}},,,      ,,, ~Y~    {{{}},,, 
  {{}}} |/,,,  ~Y~{{}}}    {{}}} |/,,,  ~Y~{{}}}
   ~Y~ \|{{}}}/\|/ ~Y~  ,,, ~Y~ \|{{}}}/\|/ ~Y~  ,,,
   \|/ \|/~Y~  \|,,,|/ {{}}}\|/ \|/~Y~  \|,,,|/ {{}}}
   \|/ \|/\|/  \{{{}}/  ~Y~ \|/ \|/\|/  \{{{}}/  ~Y~
   \|/\\|/\|/ \\|~Y~//  \|/ \|/\\|/\|/ \\|~Y~//  \|/
   \|//\|/\|/,\\|/|/|// \|/ \|//\|/\|/,\\|/|/|// \|/ 
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^