Byline is a web application and command-line utility for finding your published articles, blog posts, and other published work across the web. It uses Google Search results through SerpApi to create a spreadsheet with links, titles, dates, and other metadata, ready for use in Google Docs, Microsoft Excel, and other software.
Byline's command-line version can use Monolith to create offline HTML backups of your published work. You can also use the spreadsheet with other backup solutions, like ArchiveBox.
Hosted version coming soon!
The web app does not currently support importing existing CSV files or backing up links with Monolith. You have to install Byline and use the CLI app for those features.
Byline works on Windows, macOS, and Linux with the Node.js runtime.
Press the Win + X keyboard shortcut, and select Windows PowerShell (Admin) or Terminal (Admin). Next, copy the below command, paste it into the window (Ctrl+V), and press the Enter/Return key:
winget install -e --id OpenJS.NodeJS.LTSOpen a new PowerShell Admin window or Terminal tab, then run this command:
npm install -g serpapi-bylineYou can run byline -help to verify Byline is installed.
The process for installing Node.js and NPM varies by distribution. Here's how to do it on Ubuntu-like distros:
sudo apt install nodejs npmThen, install Byline from NPM:
npm install -g serpapi-bylineYou can run byline -help to verify Byline is installed.
Install the Homebrew package manager, then open a new Terminal window/tab and run this command to install Node.js and NPM:
brew install node
Then, install Byline from NPM:
npm install -g serpapi-bylineYou can run byline -help to verify Byline is installed.
You need to register for a free SerpApi account to use Byline.
First, open the Terminal or PowerShell again, and set the folder to store the spreadsheets and (optionally) article backups. You could use the Desktop folder with this command:
cd ~/DesktopNext, log in with your SerpApi account, which will save your API key to a byline-settings.txt file in your current folder:
byline -loginThen run Byline with -author and -site options to create the link list, with -limit set to 20 to use a maximum of 20 search credits:
byline -author "Corbin Davenport" -site howtogeek.com -limit 20This will create a file called data.csv in your folder containing all links. You can open and edit it in Microsoft Excel, Apple Numbers, LibreOffice, Google Docs, and other spreadsheet applications.
Run byline -help to see more options, like URL and publish date filters.
Byline needs Monolith installed to create HTML backups of links from the CSV file.
Install Monolith on Windows: Press the Win + X keyboard shortcut, and select Windows PowerShell (Admin) or Terminal (Admin), and run this command:
winget install --id=Y2Z.Monolith -eInstall Monolith on macOS: With Homebrew installed, open the Terminal application and run this command:
brew install monolithInstall Monolith on Linux: Check the Monolith README for installation options.
Next, switch to the folder containing your data.csv file and API key, like this:
cd ~/DesktopFinally, start the backup:
byline -backup
You can start the web server with the byline-web command, and optionally specify a port:
byline-web -port 80
The web server can also run in Docker or another compatible container engine:
docker build -t "byline:main" .
docker run -p 80:8080 -d --restart on-failure "byline:main"The Byline CLI application can read an API key from the SERPAPI_KEY environment variable. If the environment variable exists, the byline-settings.txt file will not be used.
If you want to run Byline from the checked out repository instead of the NPM package, use node src/cli.js instead of byline and node src/web.js instead of byline-web.
Found a bug that needs fixing? Have an idea for a feature? Check the issues page first, and if it's not there, please create a new issue!