DEV Community: Joseph

The Way I Use Apple Notes is... Different

Joseph — Wed, 15 Jan 2025 21:36:00 +0000

I use Apple Notes, but not the same way most people do. Most people keep their notes organized nicely in folders. I don't use folders at all.

BUT AREN'T YOUR NOTES A MESS THEN?

Nope! They're actually super organized.

BUT HOW?

I set up my Apple Notes the way the internet is set up. The internet has a bagillion-million-quintillion websites. And zero folders (that's not quite true, but it doesn't have folders that users typically click through).

i'm gonna need to refill my coffee... brb...

☕️

...k, we're good. continue.

Here's something you probably learned in school - and maybe don't think much about anymore - the internet is made of files. That's all it is, a whole bunch of files. Files of pictures, files of HTML code, files of JavaScript, all kinds of files. Most websites are made up of many files, yet the internet is not a disastrous mess.

Instead of organizing all those files into giant folders, they're given addresses. If the file is made public on the internet, any computer can access that file (or website) with a hyperlink to the file's address.

okay, you're boring me. what's the point?

The point is, Apple Notes can be configured just like the internet. Each note has an address, and any note can hyperlink to any other note by using the other note's address.

ohhhhh, so your notes are set up like the internet!

Yes, instead of storing notes in folders, I have home pages for various categories. Then, on those home pages, I have hyperlinks to all of the related notes. And to make navigation easy, I add a hyperlink back to the home page at the top of every note.

interesting. can i see what it looks like?

Here's my home page

And here's one of the sub-pages

ummm, but yeah, there's no new note button.

That's because you don't need a New Note button.

wait, for realz?

You create a new note from right inside your home note (or wherever you want the link to the new note to reside). how?

Get your cursor to whichever part of the home note you want to add the link to.
Type >> and then the name of the new note. For example, if I wanted to make a Weekly Review note, I would type >>Weekly Review.
When the little dialog box pops up, select Create note: "Weekly Review". The note will be created, and then you just have to tap the link to go to that note.
In the new note, to add a link back to the home page, use the >> again. For example, >>Home.

brb again.

☕️☕️☕️🍵

okay, i'm back... i was supposed to be sleeping, but instead i spent the night setting up my notes with hyperlinks and zero folders. but there's a problem...

Uh oh, what's the problem?

on my macbook, i can't make the sidebar go away 😬 how did you get rid of it?

Oh, getting rid of the sidebar is easy!

In the sidebar, right-click on your Home note.
Select Open Note in New Window.
After the new window opens, go back to the old window and click the red circle in the upper left corner to close it.

💥

And if you ever want to get it back, press Command+0, or restart Apple Notes, or go to the top menu, click Window and select Notes from the menu.

⚡️

And if you don't want it to come back every time you close Apple Notes, then perhaps you can create a Shortcut that only opens your Home note. I'm not sure, though. I haven't played around with that one yet. Maybe you should go do that and send me the 〜address〜 of your Shortcut.

Thanks for chatting and may your digital organizing be fun and clutter-free!

A Beginner's Guide to the Mastodon API - Post a Status Update with cURL or Python

Joseph — Sat, 30 Jan 2021 01:45:41 +0000

Originally posted at Bitsrfr.com.

If you want to program a Mastodon bot or automate your Mastodon posting, or just want to post from the command line, you've found the right corner of the internet.

I am going to show you how to connect to the Mastodon API with cURL and Python.

If you are reading this article, I assume a couple things about you:

You know what Mastodon is
You have some basic programming knowledge

Find your access token

Once you have a Mastodon account, you need your account's access token. To get that:

Sign into your Mastodon account
In the bottom left corner of your home page, click the Developers link
On the Your applications page, click the blue NEW APPLICATION button
Give your application a name, and decide what kind of access you want to have when you connect to your account via the Mastodon API (read, write, and follow is the default). You can always change this later
At the bottom of the page, click the blue SUBMIT button
You will be directed back to the Your applications page, but now you should see your application name. Click that
In your application's page, there are three tokens. For this tutorial, you need the Your access token one
- Note: if your access token is ever compromised, you can click regenerate, and your old access token will stop working, and you'll be shown a new one

Post a status update via cURL

cURL is a beautiful command line tool for send HTTP requests, and getting responses. We will use HTTP requests to communicate with Mastodon's API.

You probably already have cURL installed on your computer. You can confirm by opening a terminal, and entering curl -V.

If you don't get an error, you're good. I am using cURL version 7.68.0, but whatever version you have should work just fine.

You are going to need a couple pieces of information to communicate with the Mastodon API:

Your Mastodon server's address
Your Mastodon account's access token

Your Mastodon server's address is the address you go to in a web browser to sign into Mastodon. Mine is mstdn.social. Some other common ones are mastodon.social, switter.at, mastodon.xyz, and alive.bar.

Your Mastodon account's access token is the access token I showed you in step 7 above.

With those, you are ready to make your first Mastodon API request. Let's post a status update! Here is what mine looks like (except, that's no longer my access token because you're supposed to keep that secure).

curl https://mstdn.social/api/v1/statuses -H 'Authorization: Bearer 4-Y3nDFgrz8hV7WmbRqDAV52TiAnsQ8jeSvfbYN0g30' -F 'status=Look Mom, I can update my status via Mastodon's API!'

Let's break that request down

The first part is curl. That just tells the operating system to run the cURL program.

Next is https://mstdn.social/api/v1/statuses. That has a couple parts:

https://mstdn.social/ is my Mastodon server's address. Replace that with your own Mastodon server's address
api/v1/status is the piece of the request that tells Mastodon you want to make a status update via version 1 of the API

After the URL, we have -H. That is how we tell cURL that the next chunk of text belongs in the HTTP request's header.

The chunk of text that goes in the header, 'Authorization: Bearer 4-Y3nDFgrz8hV7WmbRqDAV52TiAnsQ8jeSvfbYN0g30' is a specification of the access token type ('Authorization: Bearer') followed by a single space, and then the Mastodon account's access token. Replace that with your own Mastodon account's access token.

Then, we have -F which tells cURL that the next chunk of text belongs in the HTTP request's form parameters.

The chunk of text that goes in the form parameters, 'status=testing the postautomaton bot!' is the form parameter field ('status') followed by an equal sign, and then text of the status update. Replace Look Mom, I can update my status via Mastodon's API! with whatever you want your status update to say.

Hit Enter, and go check your Mastodon profile. The status update should be there!

Post a status update via Python

Python is a classic scripting language. If you don't have it installed on your computer, you can grab it at python.org/downloads/.

You can check whether Python is installed, and which version, by opening a terminal, and entering python -V.

I am using Python version 3.8.5 for this example. Any version of Python 3 should work.

Same as the cURL request, for the Python request, you are going to need:

Your Mastodon server's address
Your Mastodon account's access token

Your Mastodon account's access token is the access token I showed you in step 7 above.

Here is the Python code you will run to post a status update to Mastodon. Although, yours will be slightly different because your Mastodon server and access token are probably not the same as mine.

import requests

url = 'https://mstdn.social/api/v1/statuses'
auth = {'Authorization': 'Bearer 4-Y3nDFgrz8hV7WmbRqDAV52TiAnsQ8jeSvfbYN0g30'}
params = {'status': 'Mastodon API request from Pythong!'}

r = requests.post(url, data=params, headers=auth)

print(r)

I will explain that code

The first line, import requests tells Python to use the Requests library. The Requests library is kind of like cURL. It is used for making HTTP and other internet requests.

On the next line, url = 'https://mstdn.social/api/v1/statuses', we are putting our API request URL into a variable called url. That URL gets us to the Mastodon server, and tells it that we want to use version 1 of the Mastodon API to post a status update. Make sure to replace https://mstdn.social with your own Mastodon server's address.

A line down from that, we add our authorization token to a dictionary type variable called auth. For your request, auth = {'Authorization': 'Bearer will stay the same, but replace 4-Y3nDFgrz8hV7WmbRqDAV52TiAnsQ8jeSvfbYN0g30 with your own Mastodon account's access token.

Next, we put our request parameter(s) into a dictionary type variable called params. For your request, params = {'status': ' will stay the same, but replace Mastodon API request from Pythong! with whatever you want your status update to say.

Run your Python script, and in no time at all, your status update will be posted to your Mastodon account.

One more piece of useful information

That should give you a good starting point. One more thing that will come in handy is Mastodon's API documentation: docs.joinmastodon.org/client/intro/.

If you want to jump right to the juicy part, go here.

Mastodon's documentation is in a nice standard format. It tells you what type of request is required, the URL, the headers, and the form parameters for whichever task you want to complete.

Now you are well on your way to programming a Mastodon bot, automating your Mastodon activity, and social networking via the command line. Happy hacking!

Open Source Project for ChromeOS and Chromebook Users

Joseph — Sat, 09 Feb 2019 12:32:26 +0000

I made an open source (MIT license) screen capture/recording ChromeOS application. It works, but I'm sure there are still a good number of bugs to be found in the back end. Also, the front end is very ugly at this point.

I created it because I couldn't find any other free screen recorders for Chromebooks. The paid ones typically have a free version, but it puts a watermark on the video, and I didn't want that.

I got my use out of it, so I figured I would open source it for others to use or contribute.

I would love to see someone contribute a nicer UI (just some HTML, CSS, JS stuff), but really any contributions would be super appreciated!

Here is the project repository: https://github.com/joekreydt/Captis.

Hit me up here on Dev.to, over on GitHub, or DM me on Twitter, with any comments or questions.

Peace!